本 书 推荐 


洪 舌 与 我 同事 近 8 年 ， 最 早 我 在 原来 公司 担任 CTO， 在 一 次 处 理 系统 性 能 问题 时 发 现 洪 舌 是 个 疯狂 的 技术 控 ， 那 时 的 他 虽然 刚 工 作 不 久 ， 但 是 一 直 在 学 习 一 些 前 言 技术 ， 因 此 对 他 印象 比较 深刻 。 


后 来 我 自己 创业 ， 正 巧合 他 也 有 意向 ， 我 们 一 起 一 干 就 是 4 年 。 因 为 是 创业 公司 ， 我 们 对 框架 和 平台 的 选择 主要 聚焦 在 开源 项 目 上 。 工 作 流 平台 的 选择 是 个 艰难 的 决定 ， 在 对 比 BPM 5 与 Tom 发 起 的 
Activiti 后 ， 我 决定 接受 洪 大 的 建议 选择 Activiti。 


我 们 公司 对 这 本 书 的 写作 极其 重视 。 书 中 引用 的 很 多 案例 ， 都 源 自 实际 的 项 目 中 的 使 用 经 验 。 在 使 用 过 程 中 也 遇 到 了 一 些 不 能 满足 需求 的 地 方 ， 因 此 我 们 自己 做 了 一 些 改动 并 通过 Github 贡 献 了 源 代 
码 。 目 前 为 止 , 我 们 公司 是 中 国 地 区 对 Activiti 贡 献 代 码 次 数 最 多 的 团队 ， 洪 磊 是 团队 的 技术 核心 。 这 本 书 也 算是 对 Activiti 项 目 以 及 对 开源 代码 社区 饮水 思源 的 一 种 表达 吧 。 


今年 我 们 做 了 一 个 汽车 电 商 项 目 一 一 小 马 购车 ， 初 期 拿 到 干 万 级 天 使 投资 ， 依 然 选择 Activiti 作 为 后 台 业 务 系统 的 流程 引擎 。 事 实证 明 Activiti 都 能 轻松 “Hold” 住 各 种 应 用 场景 。 
希望 本 书 能 给 大 家 在 Activiti 实 战 中 带 来 更 多 的 帮助 。 
小 马 购 车 CTO 
郑 国 强 


咖啡 兔 同学 的 《Activiti 实 战 》 终 于 出 炉 ， 欣 喜之 情 溢于言表 。 虽 然 国 内 的 工作 流产 品 繁多 ， 但 是 开源 一 直 为 Activiti 和 jBPM 垄断 。 相 对 来 说 Activiti 延 续 了 一 贯 方便 灵活 的 特性 ， 又 不 会 在 功能 上 有 半分 
折 损 ， 在 国内 拥有 大 量 的 粉丝 。 咖 啡 兔 同学 此 前 一 直 致 力 于 Activiti 在 国内 的 推广 与 传播 ， 先 后 开辟 了 专栏 博客 、Activiti 论 坛 网 站 、QQ 群 组 ， 并 且 积 极 参 与 Activiti 的 官方 开发 ， 可 以 说 Activiti 在 国内 能 达到 
当前 的 认 知 程度 ， 他 是 功 不 可 没 的 。 可 惜 ， 国 内 尚 缺 一 本 可 以 为 Activiti 新 手 答疑 解 惑 ， 带 初 阶 者 更 上 一 层 楼 的 实体 书籍 。 我 觉得 ， 这 个 任务 由 一 直 积极 活跃 于 Activiti 开 源 社区 ， 既 拥有 实际 流程 项 目 设计 研 
发 经 验 ， 又 为 Activiti 官 方 内 核 提交 过 代码 的 洪 磊 是 再 合适 不 过 了 。 

全 书 由 浅 入 深 地 引导 读者 进入 工作 流 的 殿堂 ， 不 仅 履 盖 常 见 的 流程 功能 与 实现 方法 ， 还 专门 提供 了 作者 在 实践 中 总 结 的 经 验方 法 ， 因 此 本 书 必 将 成 为 学 习 流 程 道路 上 的 得 力 助手 。 


小 米 公司 高 级 软件 研发 工程 师 《深入 浅 出 ExtJS》 作 者 jBPM、Activiti 国 内 推广 者 


徐 会 生 
在 开源 BPM 领 域 ， 你 或 许 不 知道 “ 闫 洪 磊 ” 是 谁 ， 但 你 必须 听 说 过 “咖啡 免 ”， 否 则 ， 你 不 能 说 你 曾经 玩 过 开源 BPM 1 
咖啡 免 是 我 从 事 BPM 工 作 几 年 来 ， 少 有 的 一 位 对 BPM 领 域 有 较 深 认 识 的 人 ， 同 时 他 对 开源 界 热情 的 、 积 极 的 、 无 私 的 奉献 精神 ， 让 我 感动 。 我 们 信 舟 科 技 SuperBPM 平 台 的 诞生 ， 离 不 开 咖 啡 免 提 供 的 


巨大 帮助 ， 在 此 表示 感谢 。Activiti 是 一 个 优秀 的 项 目 ， 让 我 们 能 够 很 容易 地 将 BPM3 引 入 我 们 的 企业 级 应 用 中 ， 但 Activiti 毕 竟 是 国外 的 开源 产品 ， 它 与 国内 很 多 BPM 应 用 还 是 有 些 差异 的 ， 我 们 还 需要 对 其 
做 一 些 必要 的 个 性 化 扩展 和 补充 ， 才 能 用 于 实际 的 企业 应 用 。 目 前 国内 关于 Activiti 的 专业 资料 ， 几 乎 没有 ， 而 《Activiti 实 战 》 无 疑 是 目前 最 佳 的 入 门 宝典 ， 书 中 介绍 了 很 多 案例 ， 都 是 从 实际 BPM 应 用 中 总 
结 的 宝贵 经 验 。 相 信和 你 们 将 和 我 一 样 从 中 受益 ， 并 快速 将 Activiti 集 成 到 自己 的 企业 应 用 中 ， 让 Activiti 绽 放 光 芒 。 


北京 信 朋 科技 创始 人 
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袁 启 员 
自 2010 年 Tom Bayen 离 开 jBoss 加 入 Afresco 公 司 开发 出 Activit5 以 来 ， 在 短 短 几 年 时 间 内 ， 国 内 有 大 批 企 事业 单位 和 大 型 金融 机 构 基于 Activiti5 来 构建 各 类 业务 流程 系统 ， 那 是 因为 Activiti 功 能 稳定 、 
性 能 良好 ， 对 BPMN 2 规范 完全 支持 ， 在 API 应 用 友好 性 和 扩展 性 方面 都 有 着 卓越 的 表现 。 我 从 2010 年 接触 工作 流 至 今 已 15 年 ， 认 为 Activti5 是 完全 可 以 与 Ultimus、K2 等 大 型 商用 工作 流 引 警 相 媲美 的 大 型 
开源 产品 ， 加 上 国内 有 着 咖啡 免 等 众多 开源 奉献 者 和 非常 活跃 地 社区 支持 ， 相 信和 Activiti 在 国内 BPM 界 会 发 挥 更 大 地 作用 和 价值 。 希 望 这 本 汇集 各 种 实战 经 验 的 书 能 帮助 读者 深入 了 解 Activiti。 


edoc2CTO Robinson 


咖啡 免 先生 ， 作 为 Activiti 官 方 源 代码 的 贡献 者 ， 也 是 Activiti 国 内 传道 先锋 ， 对 Activiti 的 背景 理念 、 架 构 设 计 、 开 发 运 维和 使 用 调 优 等 方方面面 的 认识 、 理 解 和 感受 ， 无 论 从 深度 还 是 广度 上 ， 都 是 项 级 
的 。 有 幸 与 先生 合作 ， 创 新 地 提出 分 布 式 平台 模式 ， 极 大 地 挖掘 和 扩展 了 Activiti 的 功能 和 使 用 范围 ， 更 为 其 谦虚 大 度 的 为 人 、 高 屋 建 领 的 思路 、 团 队 协 作 的 精神 、 全 面 扎 实 的 技术 等 所 震惊 ， 如 沐 春 风 ， 受 
益 匪 浅 。《Activiti 实 战 》 作 为 先生 力作 ， 历 时 一 年 有 余 ， 全 面 而 富有 深度 地 带领 大 家 认识 Activiti 的 世界 ， 强 烈 推 荐 |! 


通联 支付 研发 中 心 技术 部 总 经 理 


王 和 


为 什么 要 写 这 本 书 


2011 年 年 末 ， 公 司 承 接 了 一 个 保险 类 的 业务 系统 ， 包 含 处 理 核 心 业务 的 ERP 系 统 以 及 日 常 办 公 的 OA 系统 ， 很 明显 这 两 种 类 型 的 系统 都 离 不 开工 作 流 引擎 的 支持 。 我 用 一 周 时 间 对 比 了 几 个 开源 的 工作 流 
引 警 ， 最 后 决定 使 用 Activiti 作 为 整套 系统 的 工作 流 引擎 。 


现在 回想 起 来 ， 当 初 的 学 习 过 程 是 多 么 的 “痛苦 ” 啊 ! 当时 Activiti 才 刚 满 周岁 ， 除 了 官方 提供 的 尚 能 看 得 过 去 的 用 户 手册 之 外 ， 再 无 其 他 资料 可 供 参 考 ， 这 对 于 国内 开发 者 来 说 尤为 痛苦 。 仅 有 的 用 户 
手册 全 部 都 是 英文 的 ， 为 了 学 习 Activiti 只 能 打开 翻译 软件 硬 着 头皮 把 手册 看 了 一 遍 ， 当 然 也 离 不 开打 入 引擎 内 部 的 利器 一 一 Javadocs。 幸 运 的 是 ,我 的 第 一 份 工作 (3 年 时 间 ) 是 为 政府 单位 开发 OA 系统 ， 
这 有 助 于 理解 在 学 习 Activiti 过 程 中 遇 到 的 一 些 概 念 性 的 内 容 ， 在 此 基础 上 前 后 花 了 一 周 时 间 写 出 了 第 一 个 在 本 书 中 被 讲 “ 烂 ” 掉 的 请 假 流程 。 


国内 很 多 技术 爱好 者 都 会 使 用 IM 软 件 或 论坛 建立 技术 交流 社区 ， 也 有 一 些 人 开设 博客 撰写 相关 技术 文章 。 在 开始 学 习 Activiti 时 ， 很 多 人 都 尝试 着 去 寻找 这 样 的 社区 ， 结 果 由 于 社区 规模 小 、 热 度 不 高 ， 
常 听 到 学 习 资 料 荐 乏 以 及 没有 成 熟 的 Demo 可 供 参考 这 样 的 声音 。 我 喜欢 研究 技术 也 乐于 分 享 ， 从 08 年 就 开始 以 博客 的 形式 分 享 一 些 技术 学 习 心 得 ， 在 基本 掌握 Activiti 的 使 用 方法 后 就 响应 社区 的 号 召 在 
GitHub 上 公开 了 Activiti 入 门 Demo 项 目 一 kft-activiti-demo[1]， 并 在 个 人 博客 局 上 发 布 了 几 篇 与 Activiti 有 关 的 博文 。 随 着 国内 使 用 Activiti 的 企业 越 来 越 多 ， 使 得 Activiti 中 文 社区 活跃 度 大 大 增加 。 最 初 
我 要 花 不 少时 间 回答 社区 中 提出 的 有 关 Activiti 的 问题 ， 长 此 以 往 ， 同 一 个 问题 每 天 要 回答 多 次 ， 而 且 kft-activiti-demo 也 太 过 简单 ， 只 能 作为 入 门 参考 ， 为 了 能 系统 地 介绍 Activiti， 就 萌发 了 撰写 一 本 关于 
Activiti 的 书籍 的 想法 。 


在 2012 年 6 月 ， 机 械 工业 出 版 社 华章 公司 的 首席 策划 杨 福 川 联系 我 ， 表 示 有 意向 出 版 一 本 Activit 访 面 的 书籍 。 我 们 一 拍 即 合 ， 于 是 就 有 了 这 本 书 ， 这 也 让 我 相信 机 会 是 留 给 有 准备 的 人 的 。 这 本 书 原 本 
预计 一 年 完成 ， 不 过 由 于 工作 与 家 庭 的 原因 ， 在 2013 年 一 度 中 断 了 大 半年 ， 导 致 这 本 书 的 难产 。 在 此 也 对 期 待 已 久 的 读者 说 声 对 不 起 ， 同 时 也 是 因为 你 们 给 予 的 支持 与 压力 促使 我 最 终 完成 这 本 书 。 


在 学 习 和 使 用 Activiti 的 过 程 中 也 遇 到 了 一 些 Bug 或 功能 缺陷 ， 例 如 基本 上 每 个 初学 者 都 会 遇 到 的 流程 图 中 文 乱码 问题 。 对 于 这 些 问题 最 初 会 通过 Bug 跟 踪 系 统 向 官方 提交 问题 ， 在 Activiti 的 源码 从 SVN 
切换 到 GitHub 后 就 可 以 很 方便 地 让 全 球 的 开发 者 参与 进来 。 笔 者 也 借助 GitHub 这 个 平台 为 Activiti 贡 献 了 一 些 代码 ， 借 此 机 会 也 呼吁 技术 爱好 者 多 多 参与 开源 。 


读者 对 象 


本 书 以 “理论 + 实战 ”的 方式 引导 读者 学 习 ， 不 仅 介 绍 如 何 使 用 Activiti， 还 详细 介绍 了 其 遵循 的 BPMN 2.0 规 范 ， 所 以 无 论 读者 是 以 技术 为 主 还 是 以 业务 需求 为 主 ， 都 适合 阅读 本 书 。 昌 然 本 书 中 大 部 
分 示例 都 是 B/S 架 构 ， 但 不 表示 Activiti 不 能 在 C/S 架 构 中 使 用 。 另 外 ，Activiti 也 不 是 只 针对 Java 语 言 的 ， 被 其 官方 定义 为 BPM 平 台 ， 借 助 REST 也 可 以 让 非 Java 语 言 的 系统 使 用 Activiti。 


适合 阅读 本 书 的 读者 有 以 下 几 类 : 

. Activiti 用 户 和 爱好 者 

. Activiti 代 码 贡献 者 

` 流程 引 营 相关 的 项 目 经 理 或 者 需求 人 员 

" Activiti 开 发 者 ， 或 运 维 人 员 

* 使 用 Activiti 开 发 流程 平台 的 公司 
如 何 阅读 本 书 

本 书 分 为 四 大 部 分 : 

第 一 部 分 (第 1、2 章 ) 为 准备 篇 ， 介 绍 整 个 体系 结构 及 其 特点 ， 并 为 后 面 的 内 容 配置 开发 环境 。 

第 二 部 分 (第 3、4 章 ) 为 基础 篇 ， 介 绍 两 种 流程 设计 器 的 使 用 ， 以 及 BPMN 2.0 规 范 。 

第 三 部 分 (第 5~14 章 ) 为 实战 篇 ， 本 书 中 内 容 最 多 的 部 分 ， 该 部 分 以 实战 为 主 ， 包 括 流程 定义 、 流 程 实 例 、 任 务 、 子 流程 、 多 实例 、 事 件 以 及 监听 器 等 。 

第 四 部 分 (第 15~21 章 ) 为 高 级 篇 ， 通 过 集成 各 种 服务 、 中 间 件 来 前 述 Activiti 不 仅 是 引擎 ， 更 是 一 个 BPM 平 台 ， 最 后 还 深入 源码 内 部 剖析 Activiti 的 设计 模式 及 PVM。 
勘误 和 支持 


由 于 笔者 的 水 平 有 限 ， 加 之 编写 时 间 仓 促 ， 书 中 难免 会 出 现 一 些 错误 或 不 准确 的 地 方 ， 有 恳请 读者 批评 指正 。 为 此 ， 特 意 创建 一 个 在 线 支 持 与 应 急 方 案 的 站 点 http://www.kafeitu.meVactiviti-in- 
action.html。 大 家 可 以 将 书 中 的 错误 发 布 在 Bug 勘 误 表 页 面 中 ， 同 时 ， 在 遇 到 任何 问题 时 ， 你 可 以 访问 其 Q&A 页 面 ， 笔 者 将 尽量 在 线 上 为 你 提供 最 满意 的 解答 。 书 中 的 全 部 源 文件 除 可 以 从 华章 网 站 DB 下 载 
外 ， 还 可 以 从 笔者 提供 的 这 个 网 址 下 载 ， 笔 者 也 会 将 相应 的 功能 更 新 及 时 更 正 出 来 。 如 果 你 有 更 多 的 宝贵 意见 ， 也 欢迎 发 送 邮件 至 邮箱 yanhonglei@gmailcom， 期 待 能 够 得 到 你 们 的 真挚 反馈 。 
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[1] https://github.com/hentyyan/kft-activiti-demo 


[2] http:/ /www.kafeitu.me 


[3] 参见 华章 网 站 www.hzbook.com. 编辑 注 


第 一 部 分 “准备 篇 


工作 流 (Work Flow) 引擎 被 广泛 应 用 于 各 种 信息 化 系统 中 ， 将 原本 散乱 甚至 混乱 的 业务 梳理 后 制定 成 业务 规范 流程 ， 进 而 约束 业务 的 规范 化 处 理 和 和 运转。 需求 人 员 、 开 发 人 员 共 同 协作 制定 了 符合 


BPMN 2.0 规 范 的 流程 定义 ， 之 后 将 其 部 署 到 工作 流 引 擎 中 ， 由 它 自动 驱动 业务 流程 的 进行 。 


本 部 分 作为 准备 篇 ， 第 1 章 先 介绍 了 什么 是 Activiti 及 其 历史 背景 ， 然 后 介绍 工作 流 、BPM、BPMN 等 概念 ， 使 初次 接触 工作 流 的 读者 能 快速 认识 相关 概念 及 各 种 规范 。 第 2 章 内 容 从 搭建 开发 环境 开始 ， 


之 后 又 介绍 了 Activiti 的 Hello Wotld， 帮 助 读者 快速 入 门 。 


第 1 章 ”认识 Activiti 


很 多 人 对 工作 流 (Workflow) 应 该 不 陌生 。 人 生活 中 到 处 都 是 活生生 的 “ 流 ”: 在 单位 要 请 假 ， 首 先 要 找 领导 审批 ， 在 领导 审批 通过 之 后 申请 才 获准 ; 从 网 上 购物 ， 下 单 的 那 一 刻 就 已 经 触 友 了 一 条 工作 
流 ， 此 时 可 以 跟踪 购物 流程 ， 什 么 时 间 下 单 、 什 么 时 间 付 款 、 什 么 时 候 发 货 、 什 么 时 候 收 到 货 ， 在 快递 单 上 签字 的 时 候 才 等 于 一 条 工作 流程 结束 了 。 


工作 流 应 用 广泛 ， 在 由 任务 驱动 的 各 种 系统 中 都 能 见 到 它 的 身影 ， 例 如 ，CRM、ERP、ECM、BI、OA 等 。 在 企业 应 用 中 还 有 很 多 产品 或 平台 集成 工作 流 引 擎 ， 用 来 处 理 系统 运行 过 程 中 发 起 的 业务 流 


工作 流 总 是 以 任务 (Task) 的 形式 驱动 人 处 理 业务 或 者 驱动 业务 系统 自动 完成 作业 。 有 了 工作 流 引 警 之 后 ， 我 们 不 必 一 直 等 待 其 他 人 的 工作 进度 ， 直 和 白地 说 ， 我 们 只 需要 关心 系统 首页 的 待 办 任务 数 即 
可 ， 由 系统 提醒 当前 有 多 少 待 办 任务 需要 处 理 。 


1.1 什么 是 Activiti 


大 家 第 一 次 接触 Activiti 的 时 候 不 理解 它 为 什么 要 叫 这 个 名 字 ， 从 词典 中 也 没有 找到 对 它 的 解释 。 可 能 有 人 会 想到 另外 一 个 单词 Activity (活动 ) ， 与 Activiti 仅 一 个 字母 之 差 。 在 工作 流 方面 有 些 基础 的 
读者 或 许 能 很 快 理 解 ， 业 务 流程 由 多 个 环节 串联 起 来 并 且 每 个 环节 被 赋予 任务 ， 而 每 个 任务 又 可 以 分 为 多 个 活动 。 举 个 日 常 的 例子 一 一 网 上 购物 的 下 单 环节 ， 首 先 需 要 搜索 到 要 购买 的 商品 ， 然 后 将 其 加 入 
到 购物 车 ， 最 后 下 单 填写 邮寄 地 址 并 付款 。 这 个 例子 中 的 每 一 动作 都 可 以 称 为 活动 (Activity) ， 也 就 是 业务 流程 中 最 小 的 组 成 部 分 。 多 个 活动 在 英文 中 肯定 要 用 复数 形式 ， 即 Activities; 最 后 以 复数 化 简 的 
方式 标示 活动 的 集合 ， 以 此 来 诠释 Activiti 与 工作 流 的 目的 与 设计 。 


此 项 目 是 Tom Bayen (jBPM 创 始 人 ) 自 2010 年 离开 jBoss 加 入 Alfresco 公 司 后 的 又 一 力作 : 第 一 版 在 2010 年 5 月 发 布 ， 当 时 仅 支 持 最 简单 的 流程 处 理 ， 之 后 的 版 本 陆续 完善 了 对 BPM N 2.0 规 范 的 支 


值得 一 提 的 是 ， 参 与 项 目 开发 的 除了 Tom Bayen 和 十 几 位 核心 开 友 人 员 之 外 ， 还 有 其 他 公司 的 员工 参与 ,例如 ,，SpringSource、MuleSoft、Salves、Signavio、FuseSource、NextLevel 等 。 


Activiti 是 一 个 针对 企业 用 户 、 开 发 人 员 、 系 统管 理 员 的 轻 量 级 工作 流 业 务 管理 平台 ， 其 核心 是 使 用 java 开发 的 快速 、 稳 定 的 BPMNI12.0 流 程 引擎 。Activitij 是 在 ApacheV2 许 可 下 发 布 的 ， 可 以 运行 在 任 
何 类 型 的 Java 程 序 中 ， 例 如 服务 器 、 集 群 、 云 服务 等 。Activiti 可 以 完美 地 与 Spring 集 成 。 同 时 ， 基 于 简约 思想 的 设计 使 Activiti 非 常 轻 量 级 。 


Activiti 有 着 活跃 的 社区 ， 而 且 越 来 越 多 的 企业 都 选择 Activiti 作 为 自己 的 流程 引擎 或 者 将 其 嵌入 到 自己 的 系统 平台 中 (例如 ESB) 。 
接 下 来 简单 了 解 一 下 工作 流 及 其 相关 规范 的 历史 。 


[1] Business Process Modeling Notation， 详 细 信 息 可 参考 http://www.bpmn.org/。 


1.2 ”工作 流 基 础 


1.2.1 什么 是 BPM 


BPM 是 Business Process Management 的 缩写 ， 中 文 含 义 是 业务 流程 管理 ， 是 一 套 达成 企业 各 种 业务 环节 整合 的 全 面 管 理 模式 。 


BPM 是 为 了 实现 一 定 的 经 营 目的 而 执行 的 一 系列 逻辑 相关 的 活动 的 集合 。 业 务 流程 的 输出 是 满足 市 场 需要 的 产品 或 服务 。 根 据 功能 、 管 理 范围 等 的 不 同 ， 企 业 流程 管理 一 般 分 为 生产 流程 屋 、 运 作 层 、 
计划 层 和 战略 层 四 个 层次 。BMP 是 根据 业务 环境 的 变化 ， 推 进 人 与 人 之 间 、 人 与 系统 之 间 ， 以 及 系统 与 系统 之 间 的 整合 及 调整 的 经 营 方法 与 解决 方案 的 IT 工具 。 


BPM 最 早 是 由 工作 流 和 企业 应 用 集成 (Enterprise Application Intergration) 逐步 融合 而 发 展 起 来 的 ， 当 时 是 为 了 满足 无 纸 化 办 公 需 求 (这 也 是 最 早 的 需求 之 一 ) 。 笔 者 早期 参与 OA 系统 开发 时 曾经 
见 到 过 “原始 的 ”工作 流 一 一 没有 工作 流 引 擎 ， 整 个 流程 均 使 用 一 系列 单独 为 不 同 任务 节点 设计 的 页 面 串联 起 来 ， 完 成 一 个 节点 后 在 数据 库 标 记 当 前 任务 的 名 称 ， 以 此 做 到 “流程 驱动 ”。 


随 着 时 间 的 推移 ，BPM 的 定义 范围 逐步 扩展 ， 不 仅 用 来 满足 无 纸 化 办 公 需 求 ， 现 在 BPM 是 一 种 企业 集成 技术 ， 作 为 对 面向 服务 系统 架构 SOA (Service-Oriented Architecture) 、 企 业 应 用 集成 
EAI(Enterprise Application Integration)、 企 业 服 务 总 线 ESB (Enterprise Service Bus) 的 补充 。 


从 概念 上 来 说 ，BPM 包 含 两 个 不 同方 面 的 意思 : 管理 规范 和 软件 工程 。 各 大 BPM 供 应 商 长 期 以 来 试图 抽象 这 两 个 不 同 的 方面 ， 但 是 依然 混乱 。 


作为 管理 规范 ，BPM 是 每 一 个 战略 管理 者 的 责任 。BPM 是 组 织 必须 执行 的 核心 业务 流程 ， 包 含 了 企业 价值 和 如 何 提供 其 实现 。 作 为 日 常 工 作 的 一 部 分 ， 业 务 系统 可 以 借助 模型 和 流程 规范 地 定义 业务 流 
程 。 BPM 流 程 图 表达 的 是 执行 流程 的 步骤 ， 已 完成 特定 目标 。 特 别 说 明 的 是 这 些 模 型 用 于 人 与 人 的 沟通 。 这 些 都 是 诠释 未 决 的 ， 这 意味 着 它们 可 以 包含 更 高 级 别 有 价 值 的 信息 而 不 包括 不 必要 的 细节 。 这 种 
诠释 未 决 的 过 程 模型 也 被 称 为 抽象 业务 流程 (Abstract Business Processes.) 。 


BPM 作 为 软件 工程 时 可 以 由 BPM 系 统 (BPMS) 执行 可 执行 的 业务 流程 。 可 执行 的 业务 流程 是 在 一 个 流程 基础 上 表示 不 同 的 流程 顺序 。 流 程 图 完全 可 以 看 做 一 个 抽象 的 业务 流程 。 可 执行 流程 不 同 于 抽 
象 业务 流程 ， 因 为 它 总 是 以 最 简单 的 方式 运行 。 这 部 分 内 容 也 是 被 大 多 数 厂商 认同 并 接受 的 。 


1.2.2 工作 流 生 命 周 期 


一 个 完整 的 工作 流 生 命 周期 会 经 过 5 步 ， 并 且 人 迭代 循环 ， 如 图 1-1 所 示 。 


图 1-1 完整 的 工作 流 生 命 周期 


义 : 工作 流 生命 周期 总 是 从 流程 定义 开始 。 此 阶段 的 任务 主要 是 收集 业务 需求 并 转化 为 流程 定义 。 一 般 由 业务 需求 人 员 进 行 ， 然 后 交 由 开发 人 员 加 工 转化 为 计算 机 可 以 识别 的 流程 定义 。 


定义 

发 布 : 由 开发 人 员 打 包 各 种 资源 ， 然 后 在 系统 管理 〈 平 台 ) 中 发 布 流 程 定义 。 在 具体 的 流程 引擎 中 包括 流程 定义 文件 (bpmn20.xml 结 尾 ) 、 自 定义 表单 、 任 务 监听 类 。 

* 执行 : 具体 的 流程 引擎 (例如 ，Activiti) 按照 事先 定义 的 流程 处 理 路 线 以 任务 驱动 的 方式 执行 业务 流程 。 

" 监控 : 此 阶段 是 依赖 执行 阶段 。 业 务 人 员 在 办 理 任务 的 同时 收集 每 个 任务 (Task) 的 结果 ， 然 后 根据 结果 做 出 相应 处 理 ， 例 如 ， 在 采购 办 公用 品 流程 中 ， 在 通过 领导 审批 之 后 ， 采 购 人 员 就 要 根据 申 
请 单 外 出 采购 。 


* 优化: 在 此 阶段 ， 一 个 完整 的 流程 已 经 结束 ， 或 许 能 满足 业务 需求 ， 或 许 需要 优化 ， 而 粮 糕 的 情况 是 需要 重新 设计 (流程 没 结 束 就 异常 终止 ) ， 优 化 与 设计 正 是 此 阶段 需要 处 理 的 。 根 据 整 个 流程 的 


运行 过 程 结果 分 析 问 题 的 根源 ， 然 后 在 此 基础 上 进一步 改进 ， 并 再 次 开始 一 个 新 的 周期 。 


1.2.3 ”什么 是 BPMN 


Business Process Modeling Notation， 简 称 BPMN， 中 文 译 为 业务 流程 建 模 标注 ， 是 由 BPMN 标 准 组 织 发 布 的 ， 其 第 一 版 BPMN 1.0 规 范 于 2004 年 5 月 发 布 。 经 过 多 年 的 改进 新 的 规范 BPMN 2.0 于 
2011 年 发 布 。 之 后 各 大 厂商 、 开 源 社区 均 基 于 2.0 规 范 设计 自己 的 流程 引擎 ， 结 束 了 各 个 广 商 “各 自 为 政 ”的 局 面 ， 相 应 地 统一 了 标准 ， 从 而 利于 以 后 的 产品 迁移 。 


BPMN 定 义 了 业务 流程 图 ， 其 基于 流程 图 技术 ， 同 时 对 创建 业务 流程 操作 的 图 形 化 模型 进行 了 裁减 。 业 务 流程 的 模型 就 是 图 形 化 对 象 的 网 图 ， 包 括 活动 (也 可 以 说 工作 ) 和 定义 操作 顺序 的 流 控制 。 


在 BPMN 1.x 版 本 中 的 一 些 概 念 ， 如 人 工 任务 、 可 以 执行 脚本 、 自 动 决策 等 ， 都 是 独立 于 供应 商 的 可 视 化 标准 化 的 方式 。 在 BPMN 2.0 规 范 中 重点 聚焦 在 如 何 执行 语义 和 一 个 被 业界 认可 的 通用 交换 格 
式 。 这 意味 着 基于 BPMN 2.0 的 流程 建 模 不 仪 在 流程 设计 器 上 可 以 通用 ， 还 可 以 在 任何 符合 BPMN 2.0 规 范 的 流程 引擎 上 执行 。 


关于 BPMN 的 细节 内 容 有 很 多 ， 官 方 文档 足 足 有 500 多 页 ， 本 书 会 在 第 4 章 介 绍 Activiti 支 持 的 BPMN 2.0 规 范 以 及 Activiti 在 BPMN 2.0 规 范 基础 上 的 扩展 。 关 于 BPMN 的 其 他 内 容 本 书 就 不 一 一 列举 了 ， 


有 兴趣 的 读者 可 以 仔细 阅读 官方 文档 。 


1.3 ”Activiti 的 特点 


1 数据 持久 化 


Activiti 的 设计 思想 是 简洁 、 快 速 。 有 过 应 用 开发 经 验 的 开发 人 员 都 知道 应 用 的 瓶颈 体现 在 和 数据 库 交 换 数据 的 过 程 中 ， 针 对 这 一 点 Activiti 选 择 了 使 用 MyBatis， 从 而 可 以 通过 最 优 的 SQL 语句 执行 
command， 仅 任 如 此 就 能 让 引擎 在 速度 上 保持 最 高 的 性 能 。 


2. 引 擎 Service 接 口 


Activiti 引 上 擎 提供 了 七 大 Service 接 口 ， 均 通过 ProcessEngine 获 取 ， 并 且 支 持 链 式 AP 编程 风 格 。 表 1-1 简 单列 出 七 个 Service 接 口 及 其 作用 ， 具 体 使 用 会 在 后 面 的 章节 陆续 介绍 


表 1-1 Activiti 引 擎 的 七 大 Setvice 接 口 


Service 接口 作 用 
RepositoryService 流程 仓库 Service， 用 于 管理 流程 仓库 ， 例 如 ， 部 罩 、 删 除 、 读 取 流 程 资源 
IdentifyService 里 份 Service ， 可 以 管理 和 查询 用 户 、 组 之 间 的 关系 
RuntimeService 运行 时 Service， 可 以 处 理 有 所有 正在 运行 状态 的 流程 实例 、 任 务 等 
TaskService 任务 Service， 用 于 管理 、 查 询 任务 ， 例 如 ， 签 收 、 办 理 、 指 铂 等 
FormService 表单 Service， 用 于 读 取 和 流程 、 任 务 相 关 的 表单 数据 


历史 Service, 可 以 查询 所 有 历史 数据 ， 例 如 ， 流 程 实例 、 任 务 、 活 动 、 变 
、 附 件 刍 

引 警 管理 Service， 和 有 具体 业务 无 关 ， 主 要 是 可 以 查询 引 敬 配置、 数据库 、 

作业 等 


HistoryService 


一 mm 
一 一 


县 


ManagementService 


3. 流 程 设 计 器 


在 jBPM4 时 代 有 专门 的 Eclipse 插件 可 以 用 来 设计 jPDL， 同 样 Activiti 团 队 也 专门 设计 了 用 来 设计 BPM N 2.0 规 范 的 流程 设计 器 一 一 Eclipse Designer。 此 外 还 有 Signavio 公 司 为 Activiti 定 制 的 基于 Web 的 
Activiti Modeler 流 程 设计 器 。 


4. 原 生 支 持 Spring 
Activiti 原 生 支 持 Spring， 这 一 点 对 企业 应 用 来 说 尤为 重要 : 可 以 很 轻松 地 进行 Spring 集成 ， 非 常 方便 管理 事务 和 解析 表达 式 (Expression) 。 
5. 分 离 运 行 时 与 历史 数据 


Activiti 继 承 自 BPM4， 在 表 结 构 设计 方面 也 遵循 运行 时 与 历史 数据 的 分 离 ， 这 样 的 设计 可 以 快速 读 取 运 行 时 数据 ， 仪 当 需要 查询 历史 数据 时 再 从 专门 的 历史 数据 表 中 读 取 。 这 种 设计 方式 可 以 大 幅 提高 
数据 的 存 取 效 率 ， 尤 其 是 当 数据 日 积 月 宗 时 依然 能 够 快速 反应 。 


1.4 ”Activiti 的 应 用 


目前 Activiti 在 国外 已 被 很 多 厂商 所 使 用 ， 甚 至 有 人 专门 成 立 了 公司 来 培训 Activiti 的 使 用 。Activiti 在 国内 的 发 展 正在 呈 直 线 趋势 上 升 ， 已 经 成 立 了 由 很 多 热心 的 技术 爱好 者 参与 的 技术 社区 。 目 前 ， 很 多 
新 项 目 、 新 产品 都 开始 采用 Activiti 作 为 新 一 代 工 作 流 引擎 


1. 在 系统 集成 方面 应 用 
` 与 ESB (Enterprise Service Bus， 企 业 服 务 总 线 ) 整合 ， 例 如 Mule。 
.与 规则 引擎 (Rule Engine) 整合 ， 例 如 JBoss Drools。 


嵌入 已 有 系统 平台 ， 例 如 ， 很 多 公司 都 开发 了 自己 的 系统 平台 ， 在 其 中 谈 入 Activiti 作 为 平台 的 一 部 分 
2. 在 其 他 产品 中 应 用 


Alfrescol1] 公 司 的 ECM (Enterprise Content Management) 产品 Alfresco 在 企业 中 应 用 广泛 ， 主 要 涉及 文档 管理 、 协 作 、 记 录 管 理 、 知 识 库 管理 、Web 内 容 管 理 等 。 


如 果 企 业 或 客户 正在 使 用 Alfresco 管 理 文档 ， 那 么 针对 文档 管理 流程 设计 的 流程 定义 可 以 直接 部 署 在 Alfresco 上 使 用 ; 如果 之 前 没有 接触 过 jBPM 而 现在 学 会 了 使 用 Activiti， 那 么 不 用 再 去 学 习 其 他 的 流 
程 引 擎 。 关 于 Activiti 与 jBPM 的 区 别 在 1.6 节 会 提 到 |。 


在 Activit 没 有 发 布 之 前 一 直 使 用 BPM 作 为 流程 引擎 ， 在 Activiti 成 熟 以 后 Alfresco 同 时 支持 两 者 ， 当 然 在 以 后 的 某 个 时 间 可 能 会 取消 对 jBPM 的 支持 。 


[1] http:/ /www.alfresco.com/ 


1.5 ”Activiti 架 构 与 组 件 


Activiti 架 构 中 最 重要 的 肯定 是 引擎 ， 当 然 还 有 刚刚 提 到 的 外 部 工具 和 组 件 ， 如 图 1-2 所 示 。 


Modeling Runtime Management 


Activiti Modeler 


Activiti Explorer 


Activit Designer Activit Engine 


ActvIt REST 


图 1-2 ”Activiti 架 构图 
下 面 依次 介绍 Activiti 架 构图 中 的 各 个 组 件 。 


Activiti Engine: 作为 最 核心 的 模块 ， 提 供 针对 BPMN 2.0 规 范 的 解析 、 执 行 、 创 建 、 管 理 〈 任 务 、 流 程 实例 ) 、 查 询 历 史记 录 并 根据 结果 生成 报表 。 


. Activiti Modeler: 是 模型 设计 器 ， 其 并 非 由 Activiti 公 司 所 开发 ， 而 是 由 业界 认可 的 Signavio 公 司 赠送 的 (Signavio[1 原 本 是 收费 的 产品 ， 现 在 被 免费 授权 给 Activiti 用 户 使 用 ) 。 适 用 于 业务 人 员 把 需求 转 
换 为 规范 流程 定义 。 


* Activiti Designer: 功能 和 Activiti Modeletr 类 似 ， 同 样 提供 了 基于 BPMN 2.0 规 范 的 可 视 化 设计 功能 ， 但 是 目前 还 没有 完全 支持 BPMN 规 范 的 定义 。 适 用 于 开发 人 员 ， 可 以 把 业务 需求 人 员 用 Signavio 设 计 的 
流程 定义 (XML 格式 ) 导入 到 Designet 中 ， 从 而 让 开发 人 员 将 其 进一步 加 工 成 为 可 以 运行 的 流程 定义 。 


:Activiti Explotef: 可 以 用 来 管理 仓库 、 有 用户、 组 ， 启 动 流程 、 任 务 办理 等 。 此 组 件 使 用 REST 风 格 API (目的 在 于 让 开发 人 员 快 速 入 门 ) ， 提 供 一 个 基础 的 设计 模型 。 如 果 业 务 简单 ， 也 可 以 直接 使 用 
无 需 开 发 。 还 可 以 作为 后 台 管 理 员 的 流程 、 任 务 管 理 系统 使 用 。 


.Activiti REST: 提供 Restful 风 格 的 服务 ， 允 许 客户 端 以 JSON 的 方式 与 引擎 的 REST API 交 互 ， 通 用 的 协议 具有 跨 平台 、 跨 语言 的 特性 。 


[1] http://www.signavio.com/en.html 


1.6 ”Activiti 与 BPM5 比 较 


目前 流行 的 工作 流 引 警 有 Activiti 和 jBPM5， 而 在 jBPM5 发 布 以 前 大 多 数 项 目 、 平 台 都 是 基于 jBPM3、jBPM4 开 发 的 。 本 节 内 容 从 技术 和 实际 应 用 上 对 Activiti 和 jBPM 5 进行 比较 。 表 1-2 从 技术 层面 比较 
了 两 者 的 区 别 。 


表 1-2 Activiti 与 BPM5 的 技术 层面 对 比 


技术 组 成 jBPM 
ORM 框架 MyBatis3 Hibernate3 
持 2 人 从 | 无 | FA 


事务 管理 MyBatis 有 目 币 /Spring 集成 事务 Bitronix， 基 于 JTA 事务 管理 


数据 库 连 接 方式 Jdbc/DataSource Jdbc/DataSource 


原生 支持 Spring， 在 流程 中 可 以 使 用 Spring 代 
Spring 支持 理 的 Bean 作为 表达 式 的 一 部 分 ， 并 且 文 持 JPA 默认 没有 提供 对 Spring 的 支持 
及 事务 管理 


Oracle 、SQL Server、MySQL、H2、 内 存 数据 Oracle 、SQL Server、MySQL、 内 存 数 


支持 的 数据 库 i i 
库 据 库 于 
设计 模式 命令 模式 、 观 察 者 模式 等 
内 部 服务 通信 Service 间 通 过 API 调用 基于 Apache Mina 异步 通信 


集成 接口 SOAP 、Mule、RESTful 消息 通信 


支持 的 流程 格式 BPMN2、xPDL、jPDL 等 (由 PVM 实现 ) 日 前 仅 只 支持 BPMN2 xml 
引擎 核心 PVM (流程 虚拟 机 ) Drools 


技术 前 身 jBPM3、jBPM4 Drools Flow 


除了 Alfresco 人 公司 的 雇员 之 外 还 有 Spring- 
团队 成 员 Source 、MuleSoft、Salves、Signavio、FuseSource,、 
NextLevel 等 公司 的 员工 加 入 


是 供 了 基于 Eclipse 捕 件 的 流程 设计 项 
Eclipse ee ， 提 供 基 于 REST 风格 的 Activiti 同样 提供 Eclipse 插件 和 一 个 Web 应 用 


有 一 个 专门 的 团队 ， 此 外 还 有 一 些 个 人 


ee Explorer， 可 以 用 来 沁 理 仓库 、 用 户 、 组 、 局 动 | 管理 流程 
流程 、 任 务 办 理气 
发 布 周期 国定 每 两 个 月 发 布 一 版 ， 其 中 包括 : jBPM 的 发 布 周 4“ 对 来 说 不 太 固定 ， 


Eclipse Designer 、Activiti Explorer 、REST ae 发 布 内 容 包 括 引 擎 及 基于 Eclipse 的 设计 项 


Activiti 是 基于 jBPM4 设 计 的 衍生 版 本 ， 如 果 选 择 Activiti 可 以 继续 沿用 BPM 的 思想 理念 设计 、 整 合 Activiti 到 项 目 或 平台 中 ， 这 也 是 相对 于 jBPM5 来 说 的 一 个 优势 ， 相反 ， 对 于 jBPM5 来 说 要 花 点 时 间 重 
新 接受 开发 者 的 设计 思想 。 


在 各 个 流程 引擎 社 区 中 有 很 多 关于 该 如 何 选择 Activiti 和 jBPM5 的 讨论 ， 这 两 者 有 着 很 多 相似 的 地 方 ， 争 论 主要 是 对 规则 引擎 的 支持 : jBPM5 是 基于 Drool Flow 所 有 自然 深度 继承 而 来 的 规则 引擎 
Drools; 早期 的 Activiti 功 能 比较 简单 ， 后 来 陆续 添加 的 新 特性 也 支持 规则 引擎 Drools， 开 发 人 员 只 要 简单 配置 规则 接口 即 可 达到 与 jBPM 5 一 样 的 效果 。 


1.7 本 章 小 结 
本 章 内 容 主要 是 以 初 识 工作 流 和 Activiti 的 角度 去 讲解 什么 是 工作 流 、 什 么 是 Activiti。 从 Activiti 项 目的 发 起 、 特 点 、 应 用 、 架 构 ， 以 及 与 其 他 同类 产品 比较 的 角度 在 概念 层 给 读者 一 个 引导 和 认识 。 
作为 一 个 开发 人 员 ， 能 够 知道 为 什么 需要 学 习 Activiti，Activiti 能 帮助 企业 解决 什么 问题 ， 为 什么 要 选择 Activiti 而 不 是 其 他 的 工作 流 引 擎 。 
看 到 这 里 你 或 许 会 不 耐烦 了 ， 会 想起 一 句 话 : “Talk is cheap.Show me the code[1]”。 下 一 章 将 带领 你 体验 Activiti 的 Hello World。 


四 这 是 Linux 的 作者 Linus Torvalds 的 名 言 ， 意 思 是 : 能 说 算 不 上 什么 ， 有 本 事 就 把 你 的 代码 给 我 看 看 。 


第 2 章 ”搭建 Activiti 开 友 环 境 


第 1 章 介绍 了 关于 工作 流 的 概念 及 Activiti 的 发 起 背景 ， 带 领 大 家 大 体 了 解 Activiti 能 帮助 企业 解决 什么 问题 ， 作 为 一 个 开发 人 员 为 什么 需要 学 习 Activiti， 还 简单 介绍 了 一 下 Activiti 的 架构 以 及 与 其 他 工作 
流 引 擎 的 区 别 。 本 章 将 带领 你 一 步 一 步 搭 建 开 发 环境 ， 并 运行 期 待 已 久 的 Hello World 程 序 。 


2.1 下载 Activiti 
通过 浏览 器 访问 页 面 : http://activiti.org/download.html， 其 中 列 出 自 Activiti 发 布 以 来 历次 版 本 的 压缩 包 和 相关 文档 (10 分 钟 入 门 、 用 户 手册 以 及 JavaDoc) 。 


在 “Latest Release” 处 下 载 下 面 的 压缩 包 ， 在 笔者 写作 本 书 时 最 新 版 本 为 Activiti 5.9。 细 心 的 读者 可 能 注意 到 : 在 “Older releases” 的 发 布 列表 中 5.6 版 本 之 前 基本 上 是 一 个 月 发 布 一 版 ， 从 5.6 版 本 之 后 
基本 固定 为 2~ 3 个 月 发 布 一 版 。 


图 说 明 初学 者 很 难 理解 的 地 方 是 ， 为 什么 Activiti 的 版 本 从 5.0 开 始 ? 在 第 1 章 的 内 容 中 提 到 过 Activiti 是 基于 jBPM4 开 发 的 ， 所 以 就 直接 版 本 号 累加 ， 最 终 从 5.0 版 本 开始 。 


2.1.1 ”目录 结构 


在 最 初 撰写 本 章 内 容 时 最 新 的 版 本 为 5.9， 目 录 结 构 和 下 一 版 本 (5.10) 一 致 但 是 从 5.11 版 本 开始 发 生 了 比较 大 的 变化 ， 所 以 分 两 个 小 部 分 说 明 两 者 在 目录 结构 上 的 不 同 。 本 书 完稿 时 最 新 版 本 为 
5.16.3。 


1.5.10 及 之 前 的 版 本 
对 于 Activiti 5.10 及 之 前 的 版 本 ， 解 压 压 缩 包 之 后 目录 结构 如 图 2-1 所 示 。 
下 面 我 们 来 详细 介绍 图 2-1 中 的 目录 结构 。 
docs， 该 目录 包含 了 三 种 文档 : javadocs、userguide、xsd。 
. javadocs: 包 名 按照 功能 模块 划分 ，org.activiti.engine. ， 接 下 来 在 2.1.2 节 中 详细 介绍 。 
userguide: 用 户 手 册 ， 包 含 环境 配置 、10 分 钟 快速 入 门 ， 以 及 各 个 功能 模块 的 使 用 教程 。 
.xsd: 包含 BPMN 2.0 规 范 的 XSD 文件 ， 以 及 Activiti 扩 展 的 自 定义 标签 XSD。 
.setup: 用 来 构建 、 启 动 Activiti Explorer 演 示 程 序 。 通 过 ant demo.statt 命 令 即 可 自动 下 载 tomcat， 配 置 数据 库 ， 最 后 打开 浏览 器 访问 应 用 。 具 体操 作 将 在 2.4 节 详细 介绍 。 


.wotkspace: 该 目录 包含 了 各 种 应 用 的 实例 程序 ， 都 以 单元 测试 的 形式 展示 功能 的 使 用 方式 。 读 者 可 以 直接 将 项 目 导 入 Eclipse 查看 其 源 代码 ， 从 而 通过 断 点 调试 来 学 习 。 


Y | activiti-5.10 
Y 国 apps 
上 h2 


javadocs 
> | userguide 


build.db.properties 
build.oroperties 


build.xml 
vv ll workspace 
activiti-cxf-examples 
activiti-engine-examples 
activiti-groovy-examples 
activiti=jpa=examples 
activiti-modeler-examples 
activiti-spring-examples 
| license.txt 
“| notice.txt 
® readme.html 


图 2-1 Activiti 5.10 及 之 前 版 本 的 目录 结构 


2.5.11 及 之 后 的 版 本 
对 于 Activiti 5.11 及 之 后 的 版 本 ,解压 压缩 包 之 后 目录 结构 如 图 2-2 所 示 。 
下 面 我 们 来 详细 介绍 图 2-2 中 的 目录 结构 。 


" Database， 该 目录 包含 了 针对 Activiti 引 擎 表 的 创建 (create) 、 删 除 (drop) 及 版 本 升级 (upgrade) 三 种 类 型 的 脚本 : 创建 、 删 除 类 型 的 脚本 以 “activiti.oracle.[create | drop]. 
lidentity |engine |history].sql” 这 样 的 结构 命名 SQL 脚 本 文件 ;升级 脚本 以 “activiti.oracle.upgradestep.[5x].to.[5(x+1)].history” 的 结构 命名 SQL 脚 本 文件 ， 其 中 “x” 表 示 小 版 本 号 。 


` docs， 该 目录 也 包含 了 三 种 文档 : javadocs、usereuide、xsd。 
javadocs: 包 名 按照 功能 模块 划分 ，org.activiti.engine.*， 接 下 来 在 2.1.2 节 中 详细 介绍 。 
usetguide: 用 户 手 册 ， 包 含 环境 配置 、10 分 钟 快速 入 门 ， 以 及 各 个 功能 模块 的 使 用 教程 。 
xsd: 包含 与 流程 定义 相关 的 scheme， 例 如，BPMN 2.0、BPMNDI 及 Activiti 在 BPMIN 2.0 规 范 上 扩展 的 元 素 。 


.libs: 相 比 5.10 之 前 的 版 本 移 除 了 第 三 方 的 依赖 ， 仅 仅 包含 了 Activiti 引 擎 的 各 个 模块 (engine、bpmn-convetter、bpmn-model、camel、cdi、cxf、json-convertetr、modeler、mule、osgi、test、sptring) 的 class 
文件 以 及 源码 。 这 么 做 的 目的 是 通过 Maven 管 理 依赖 (在 2.3.2 节 介绍 了 如 何 使 用 Maven 管 理 依 赖 ) 避免 因 Jat 版 本 不 同 导 致 冲突 (大 部 分 开源 项 目 及 国外 的 项 目 都 使 用 Maven 管 理 依赖 ， 所 以 强烈 建议 没 接触 过 


Maven 的 读者 花 点 时 间 学 习 使 用 它 ) 。 


. wats: 从 5.11 版 本 开始 对 exploret 模 块 和 rest 模 块 进行 了 拆 分 ， 使 得 rest 模 块 可 以 独立 运行 ; 运行 explorer 的 方式 也 随 之 发 生 了 变化 ， 不 再 使 用 ant 脚 本 (2.5.1 节 ) 运行 ， 而 是 提供 一 个 独立 的 war 包 ， 自 行 部 
署 tomcat 或 jboss 等 Web 服 务 器 中 。 


v Bl activiti-5.11 
a database 
> create 
p> drop 
> upgrade 
Vv docs 
> javadorcs 
> userguide 
> 疤 | xsd 
bp Ol libs 
MA Wars 
与 | activiti-explorer.war 
司 | activiti-rest.war 
| license.txt 
notice.txt 
readme.html 


图 2-2 ”Activiti 5.11 及 之 后 版 本 的 目录 结构 


2.1.2 Javadocs 


Javadocs 是 开发 人 员 与 Activiti 交 流 的 “语言 ”， 在 开始 编写 第 一 个 Hello World 之 前 先 来 大 致 了 解 一 下 每 个 包 (也 就 是 module) 的 功能 及 各 个 接口 的 作用 。 当 然 不 太 想 了 解 这 些 内容 的 读者 也 可 以 暂时 


跳 过 这 里 ， 直 接 开始 搭建 环境 并 编写 第 一 个 Hello World 程 序 ， 最 后 再 回 过 头 来 了 解 。 
Javadocs 一 共 包 含 11 个 package， 下 面 依次 介绍 它们 的 作用 范围 。 


1) org.activiti.engine: 包含 上 一 章 提 到 的 七 大 类 Service 接 口 、 异 常 类 定义 和 流程 引擎 (Process Engine) 及 流程 引擎 配置 (Process Engine Configuration) ， 另 外 还 定义 了 一 些 运行 时 (Runtime) 


已 水 米 
异常 类 。 


2) orgactiviti.engine.delegate: 该 包 定 义 了 处 理 流程 的 行为 、 监 听 事 件 的 规范 。 在 实际 应 用 中 可 以 在 流程 定义 中 配置 实现 了 监听 接口 的 类 处 理 业务 逻辑 ， 例 如 可 以 在 流程 结束 时 由 系统 自动 归档 。 在 第 1 章 
中 提 到 过 Activiti 使 用 的 是 监听 者 (Observer) 模式 ， 在 流程 运行 过 程 中 (任务 完成 ) 引擎 会 遍历 注册 的 监听 并 依次 调用 。 


3) orgactiviti.engine.form: 该 包 应 用 在 内 置 表 单 的 场景 下 ， 在 一 些 企业 或 客户 要 求 自 定义 表单 的 需求 中 使 用 。 定 义 表单 有 两 种 方式 : 第 一 种 是 直接 在 流程 定义 中 设置 每 个 节点 的 表单 内 容 ， 可 以 设置 每 
个 字段 (Field) 的 类 型 、 是 否 可 以 编辑 等 属性 ; 另外 一 种 就 是 通过 外 置 表单 的 形式 ， 通 过 formkey 指 定 外 置 表单 文件 的 名 称 ， 类 型 可 以 是 .xm| 或 .form。 表 单 的 读 取 、 提 交 均 可 以 通过 Formservice 接 口 完 
成 。 

4) org.activiti.engine.history: 该 包 包 含 了 历史 记录 查询 对 象 及 查询 结果 的 历史 数据 对 象 接口 。 可 以 查询 历史 流程 实例 (HistoricProcesslnstance) 、 历 史 任务 (HistoricTask) 、 历 史 活 动 
(HistoricActivity) 、 历 史 详 细 (HistoricDetail) 等 。 在 13.3 节 中 ， 流 程 跟 踪 功 能 就 是 通过 HistoryService 接 口 进行 查询 来 实现 的 。 


5) org. activiti.engine.identity : 该 包 可 以 用 来 管理 身份 和 认证 5 功能 依托 IdentitySe rvice 接 口 o 在 这 里 需要 说 明 一 下 7 Activiti 有 自 己 的 | dentify 模 块 因为 流程 中 的 用 户 任务 ( userTa sk) 需要 指派 给 
个 人 或 某 个 角色 。 关 于 任务 指派 在 后 面 12.1.3 节 会 介绍 。 讲 到 这 里 顺便 提 一 下 ， 关 于 身份 认证 管理 功能 和 企业 中 已 有 身份 认证 管理 模块 的 冲突 解决 办 法 将 在 第 19 章 中 详细 讨论 。 


6) org.activiti.engine.management: 该 包 主要 是 用 来 实现 针对 流程 引擎 的 管理 功能 ， 通 过 调用 接口 Managementservice 可 以 监控 引 警 状态 、 任 务 调度 、 数 据 库 数据 读 取 。 
7) orgactivitiengine.query: 该 包 没 有 具体 的 功能 ， 定 义 了 查询 的 共有 特性 。 细 心 的 读者 在 查看 API 的 时 候 会 发 现 XxxQuery 接 口 均 继承 自 Query， 并 且 使 用 了 JDK 5 提供 的 泛 型 。 


8) org.activiti.engine.repository: 该 包 包含 了 针对 流程 资源 的 管理 与 查询 。 依 托 RepositoryService 接 口 可 以 部 署 流程 定义 、 自 定义 表单 、 规 则 等 文件 ， 还 可 以 读 取 流程 图 片 、 流 程 定义 (bpmn20.xml) 
文件 。 


9) orgactiviti.engine.runtime; 在 第 1 章 中 提 到 了 Activiti 把 流程 数据 划分 为 两 种 : 运行 时 数据 和 历史 数据 。 刚 刚 介 绍 了 org.activitiengine.history 包 依托 HistoryService 查 询 历史 数据 ， 相 应 地 ， 也 可 以 通 
过 RuntimeService 接 口 查询 运行 时 数据 ， 例 如 可 以 查询 出 当前 用 户 的 待 签收 任务 、 待 处 理 任务 ， 以 及 正在 处 理 中 的 流程 实例 对 象 。 当 然 除了 查询 数据 之 外 还 要 启动 流程 ， 然 后 得 到 实现 了 Processlnstance 
接口 的 实例 ， 从 而 在 业务 中 根据 流程 实例 继续 处 理 业务 信息 。 另 外 在 Activiti 5.9 版 本 中 添加 了 对 流程 定义 状态 的 控制 功能 : 挂 起 和 恢复 。 


10) org.activiti.engine.task: 该 包 包含 任务 对 象 的 定义 ， 依 托 Taskservice 接 口 可 以 对 任务 (Task) 全 面 管 理 ， 例 如 ， 任 务 创建 、 删 除 、 任 务 指派 、 批 注 管理 、 附 件 管理 以 及 变量 查询 。 人 在 12 章 将 会 逐一 介 


绍 TaskService 操 控 Task。 


11) org.activiti.engine.test: 顾名思义 ， 该 包 针 对 快速 创建 测试 用 例 提 供 基 类 和 注解 (Annotation) 。 现 在 已 经 有 很 多 公司 或 开发 人 员 使 用 测试 驱动 (Test Driven Development，TDD) 方式 编 
码 ，Activiti 提 供 的 这 一 功能 大 大 方便 了 验证 流程 定义 中 业务 逻辑 正确 与 否 的 效率 。 此 包 不 仅 提 供 了 测试 基 类 ， 还 支持 注解 (Annotation) 方式 自动 部 署 流程 定义 。 本 书 的 很 多 示例 也 将 先 以 TDD 方 式 引导 读 
者 学 习 。 


2.2 ”环境 配置 检查 
在 准备 搭建 开发 环境 之 前 需要 读者 检查 自己 的 系统 环境 是 否 已 安装 JDK、Ant 和 Maven， 如 果 已 经 安装 ， 那 么 需要 检查 版 本 是 否 满 足 Activiti 的 最 低 要 求 。 
2.2.1 ”检查 并 安装 JDK 


在 Activiti 5.10 版 本 之 前 要 求 JDK 的 最 低 版 本 为 JDK 1.5 ( 即 5.0) ， 从 Activiti 5.11 版 本 开始 要 求 最 低 JDK 为 1.6 ( 即 6.0) ;如果 本 地 配置 低 于 不 同 版 本 的 最 低 要 求 ， 那 么 需要 到 Oracle 官 方 下 载 


(http://www.oracle.com/technetwork/java/javase/downloads/index.html) 并 安装 。 
在 检查 JDK 前 先 确认 JAVA_HOME 已 正确 设置 。 
1) Windows 用 户 : 
C:\Documents and Settings\henryyan> >echo%JAVA HOME% 
C:\Documents and Settings\henryyan> >java-version 
2)Linux、Mac OS 用 户 : 
henryyan@hy-hp~echo$JAVA HOME 
henryyan@hy-hp~java-version 


笔者 的 Java 环 境 如 图 2-3 所 示 。 


= henryyan@hy-hp java -version 
Java version "1.6.0 30" 


Java(TM) SE Runtime EnvIronment (build 1.6.0_30-b12) 
BEVE 64-Blt Server VM (bulld 20.5-b03，mlxed mode) 


图 2-3 ”在 Linux 系 统 中 安装 配置 Java 环 境 


2.2.2 ”检查 并 安装 Ant 


Activiti Explorer 在 1.5 节 已 经 提 到 了 ， 可 以 快速 运行 示例 程序 。 示 例 程 序 需要 使 用 Ant 构 建 运行 。 

官方 要 求 Ant 的 版 本 为 1.8.1 或 更 高 ， 如 果 本 地 没有 Ant 安 装 软件 ， 那 么 先 从 Apache 网 站 下 载 (http://ant.apache.org/bindownload.cgi) ， 然 后 将 其 解压 并 安装 到 本 地 目录 。 
检查 Ant 前 先 确认 ANT_HOME 是 否 已 正确 设置 。 

1) Windows 用 户 : 

C:\Documents and Settings\henryyan>echo%ANT HOME% 

C:\Documents and Settings\henryyan>ant-version 

2) Linux、MacOS 用 户 : 

henryyan@hy-hp~echo$ANT HOME 

henryyan@hy-hp~ant-version 


笔者 的 Ant 环 境 如 图 2-4 所 示 。 


l= henryyan@hy-hp ~ echo $ANT_HOME 
{opt/devtools/ant/apache-ant 


”> henryyan@hy-hp ~ ant -version 
Apache Ant(TM)》 verslon 1.8.4 compliled on May 22 2012 


图 2-4 在 Linux 系 统 中 安装 配置 Ant 环 境 

2.2.3 ”检查 并 安装 Maven 

Maven 作 为 一 款 优秀 的 构建 工具 (不 仅仅 是 构建 ) 已 经 被 全 球 很 多 的 开发 者 、 开 源 组 织 使 用 ， 近 年 来 也 被 国内 越 来 越 多 的 公司 和 组 织 使 用 。 未 接触 Maven 或 不 太 熟悉 相关 内 容 的 读者 可 以 参考 国内 
Maven 专 家 许 晓 斌 著 的 《Maven 实 战 》。[ 

Activiti 引 警 的 源码 也 是 使 用 Maven 构 建 的 ， 并 且 公 开 Maven 仓 库 方 便 开 发 者 下 载 引 擎 。 本 书 所 有 示例 程序 都 将 使 用 Maven 管 理 依赖 ， 所 以 读者 一 定 要 检查 Maven 的 配置 是 否 正 确 。 

如 果 还 未 安装 Maven， 那 么 先 从 Apache 网 站 下 载 (http://maven.apache.org/download.html) ， 然 后 将 其 解压 到 本 地 目录 。 

侈 查 Maven 前 要 先 确认 MVN_HOME 是 否 设置 。 

1) Windows 用 户 : 

C:\Documents and Settings\henryyan>echo%MVN HOME% 

C:\Documents and Settings\henryyan> mvn-v 

2) Linux、Mac OS 用 户 : 

henryyan@hy-hp~echo$MVN HOME 

henryyan@hy-hp~mvn-v 


笔者 的 Maven 环 境 如 图 2-5 所 示 。 


henryyan@hy-hp ~ echo $MVN_HOME 
/opt/devtools/maven/apache-maven 

henryyan@hy-hp ~ mvn -v 
Apache Maven 3.0.4 (r1232337; 2012-01-17 16:44:56+0800) 


Maven home: /opt/devtools/maven/apache-maven 

Java version: 1.6.0_30, vendor: Sun Microsystems Inc. 

Java home: /opt/devtools/]Jdk/Jdk1i.6.0 307]re 

Default locale: en_US, platform encoding: UTF-8 

O05s name: "]inux", version: "3.2.0-24-generic", arch: "amd64", family: "unix" 


图 2-5 ”在 Linux 系 统 中 安装 配置 Maven 环 境 


[1] http://www.juvenxu.com/mvn-in-action 


2.3 ”配置 文件 介绍 
本 节 来 介绍 两 个 配置 文件 ， 一 个 是 Maven 的 pom.xml 文 件 ， 另 外 一 个 就 是 Activiti 的 默认 配置 文件 activiti.cfg.xml。 


2.3.1 Activiti 配 置 文件 


在 bpmn20-example 工 程 的 src/test/resources 中 有 一 个 activiti.cfg.xml 文 件 ， 此 文件 就 是 Activiti 的 配置 文件 ， 用 来 定义 引擎 初始 化 参数 、bean、 邮 件 服务 器 及 各 种 监听 器 。 
代码 清单 2-1 展 示 了 一 个 标准 的 Activiti 配 置 文件 。 


代码 清单 2-1 标准 的 Activiti 配 置 文件 


<?xml] VerSsion="1.0" encoding="UTF-8"?> 
<beans xmlns="http://www. Springf framework .org/schema/beans" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation=" 'http: //www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans.xsd"> 
<bean igd=" processE EngineConfiguration" #1 


class="org.activiti.engine.impl.cfg.StandaloneInMemProcessEngineConfiguration"> #2 
<property name="databaseType" value="h2" /> #3-S 
<property name="databaseSchemaUpdate" value="true"/> 


<property name="jobExecutorActivate" value="false" /> 
<property name="history" value="full" /> #3-E 
</bean> 
</beans> 


在 第 1 章 中 提 到 过 Activiti 和 Spring 无 颖 集成 ， 熟 悉 Spring 的 读者 一 眼 就 看 出 来 这 就 是 Spring 的 配置 文件 。 是 的 ， 在 XML 的 命名 空间 中 定义 了 spring-bean,， 


即 http:/www.springframework.org/schema/beans。 
#1 处 定义 了 一 个 id 为 processEngineConfiguration 的 bean 对 象 ， 其 中 processEngine-Configuration 即 为 Activiti 默 认 的 引擎 配置 管理 器 名 称 。 


#2 处 指定 了 一 个 具体 的 Java 类 ， 由 Spring 负 责 实 例 化 引擎 配置 管理 器 并 注入 #3 处 的 一 系列 配置 参数 。 此 处 的 引擎 配置 管理 器 是 基于 内 存 数 据 库 的 ， 因 为 其 速度 快 ， 常 用 于 测试 环境 。 


#3 处 的 配置 参数 含义 如 表 2-1 所 示 。 


表 2-1 Activiti 引 擎 配置 管理 器 的 参数 及 其 含义 


属性 名 称 属性 说 明 


数据 库 类 型 ， 默 认为 H2。 当 使 用 非 H2 数据 库 时 需要 特 声明 ， 例如 在 生产 环境 中 
databaseType 一 般 不 会 使 用 H2 作为 数据 库 目前 Activiti 文 持 的 数据 库 有 : H2、MySQ1、Oracle、 
Postgres . MSSQI1、DB2 


用 来 声明 数据 库 脚 本 更 新 策略 ， 和 hibernate 的 机 制 类 似 。 取 值 如 下 : 
口 false， 什 么 都 不 做 
databaseSchemaUpdate D true， 当 Activiti 的 表 不 存在 时 目 动 创建 ; 当 Activiti 的 jar 文件 中 定义 的 版 本 号 与 
效 据 库 中 记录 的 版 本 号 不 一 致 时 会 目 动 执 行 相应 的 升级 脚本 ， 并 且 会 记录 升级 过 程 
口 create-drop ， 创 建 引 擎 时 执行 初始 化 脚本 ， 引 警 销毁 时 执行 删除 数据 库 脚本 


用 来 设置 是 否 启 用 作 业 执行 功能 ， 默认 为 false。 在 将 该 值 设 置 为 true 之 后 ， 引 擎 会 

jobExecutorActivate 不 间断 地 刷新 分 查 是 否 存 在 需要 执行 的 作业 ， 有 则 触发 作业 的 执行 
作业 的 来 源 有 多 种 ， 例 如 各 种 时 间 事件 或 异步 任务 执行 

用 来 设置 记录 历史 的 级 别 ， 黑 认为 audit。 文 持 以 下 几 种 类 型 : 
none, PET 何 历史 记录 ， 可 以 提高 系统 性 能 
activity， 保 和 存 所 有 的 流程 实例 、 任 务 、 活 动 信 息 
audit， 也 是 Activiti 的 默认 级 别 ， 保 存 所 有 的 流程 实例 、 任 务 、 表单 属性 
full : 最 完整 的 历史 记录 ， 除 了 包含 audit 级 别 的 信息 之 外 还 保存 详细 ， 例 如 流程 
变量 、 表 单 属性 


的 


TH 


history 


DJ DOD DUO 


2.3.2 ”Maven 配 置 文件 


讲解 Maven 配 置 文件 主要 是 针对 没有 接触 过 Maven 或 对 Maven 不 太 熟 悉 的 读者 。 
打开 bpmn20-example 中 的 pom.xm| 查 看 文件 内 容 。 下 面 以 代码 片段 的 形式 说 明 Maven 配 置 文件 的 作用 。 


要 在 Maven 项 目 中 使 用 一 个 依赖 只 需要 声明 groupld、artifactld、version 三 个 属性 即 可 ， 有 具体 的 XML 如 下 : 


<dependency> 
<groupId>org.activiti</groupId> 
<artifactId>activiti-engine</artifactId> 
<version>${activiti.version}</version> 
</dependency> 


其 中 : 

" groupld， 一 般 以 公司 或 组 织 的 域名 倒序 定义 ; 

artifactId， 一 个 组 件 的 ID 标 识 ; 

“ version， 依 赖 的 版 本 ， 此 处 用 一 个 占 位 符 代替 实际 的 版 本 号 。 


version 标 签 中 的 ${activiti.version} 表 达 式 可 以 在 properties 标 签 中 定义 属性 的 值 ， 如 下 : 


<properties> 


<activiti.version>5.10</activiti.version> 
</properties> 


通过 指定 activiti.version 为 5.10，Maven 就 知道 需要 从 仓库 下 载 版 本 为 5.10 的 Activiti 对 应 的 jar 文 件 ， 还 可 以 下 载 依赖 组 件 的 javadocs 或 sources 等 。 


Maven 在 需要 下 载 依赖 的 时 候 默 认 从 中 央 仓 库 搜索 ， 当 匹配 到 存在 的 组 件 时 将 其 从 远程 下 载 到 本 地 仓库 。 但 是 ， 当 中 央 仓 库 不 存在 某 个 组 件 的 时 候 就 需要 定义 第 三 方 仓库 供 Maven 查 询 、 下 载 。 目 前 
Activiti 还 未 被 收录 到 中 央 仓 库 ， 所 以 我 们 需要 指定 一 个 第 三 方 仓库 ， 即 Activiti 提 供 的 仓库 ， 告 诉 Maven 当 找 不 到 依赖 时 从 此 仓库 查询 。 以 下 代码 定义 了 Activiti 的 公开 仓库 (从 5.14 版 本 开始 ， 可 以 从 
Maven 中 央 仓 库 直 接 下 载 ) : 


<!1-- Maven 仓 库 定 义 --> 
<repositories> 
<!-- Activiti 的 仓库 --> 
<repository> 
<id>Activiti</id> 
<url>http://maven.alfresco.com/nexus/content/repositories/activiti</url> 
</repository> 
</ repositories> 


以 此 类 推 ， 当 日 常 开发 中 遇 到 某 些 依 赖 组 件 不 存在 的 情况 时 ， 可 以 先 查 看 官方 网 站 是 否 提 供 了 Maven 仓 库 ， 如 果 有 则 加 入 到 repositories 中 ， 否 则 只 能 用 私服 的 方式 (私服 如 何 使 用 不 在 本 书 讨论 范围 
内 ， 读 者 可 以 参考 《Maven 实 战 》 一 书 ) 。 


2.4 Hello World 


Hello World 如 此 经 典 ， 几 平 每 学 习 一 门 新 技术 都 从 它 开始 ， 它 是 一 把 打开 技术 之 门 的 万 能 钥匙 ， 因 为 通过 Hello World[1] 能 快速 了 解 一 门 技术 如 何 配置 、 运 行 ， 以 及 得 到 什么 样 的 结果 。 


好 吧 ， 让 我 们 一 起 开启 探索 Activiti 的 大 门 。 
2.4.1 最 简单 的 流程 定义 


代码 清单 2-2 是 一 个 最 简单 的 请 假 流 程 定义 文件 ， 简 单 到 仅 有 开始 节点 和 结束 节点 。 


代码 清单 2-2 最 简单 的 请 假 流程 定义 文件 leave.bpmn 


<?xml] version="1].0" encoding="UTF-8"?> 
<definitions xmlns="http://www.omg.org/spec/BPMN/20100524/MODEL" #1-S 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:activiti="http://activiti.org/bpmn" 
xmlns:bpmndi="hnttp://www.omg.org/spec/BPMN/20100524/DI" xmlns:omgdc="http://www.omg.org/spec/DD/20100524/DC" 
xmlns:omgdi="http://www.omg.org/spec/DD/20100524/DI" typeLanguage="http://www.w3.org/2001/XMLSchema" 
expressionLanguage="http://www.w3.org/1999/xPath" targetNamespace="http://www.kafeitu.me/activiti-in-action"> #1—E 
<process id="leave" name="Leave"> #2 
<startEvent id="starteventl" name="Start"></startEvent> #3 
<endEvent id="endeventl1l" name="End"></endEvent> #4 
<sequenceFlow igd="flowl" name="" sourceRef="starteventl1" #5 
targetRef="endevent1"></sequenceFlow> 


</process> 
在 解释 这 个 文件 的 内 容 之 前 我 们 先 来 了 解 一 下 为 了 更 好 地 理解 代码 含义 本 书 所 做 的 一 些 约定 。 
@@ 说 明 # 号 后 面 加 数字 用 来 表示 代码 清单 的 第 几 处 (不 是 行 号 ) ， 其 中 1-S 和 1- 已 分 别 代表 第 1 处 标记 的 开始 (Start) 和 结束 (End) 。 


在 详细 讲解 流程 定义 文件 之 前 还 要 来 看 看 对 应 的 图 片 形式 的 流程 定义 ， 如 图 2-6 所 示 。 


图 2-6 最 简单 的 流程 定义 


在 代码 清单 2-2 中 ，1-S 处 的 definitions 标 签 表 示 BPMN 2.0 规 范 中 定义 的 开始 ， 可 以 包含 多 个 process 标 签 ; 紧 跟着 是 XMLSchema 的 定义 ， 用 来 验证 XML 内 容 是 否 符合 规范 ;最 后 一 个 属性 
targetNamespace 是 必需 的 ， 用 来 声明 命名 空间 。 为 什么 必须 定义 targetrNamespace 呢 ? 命名 空间 是 BPMN 2.0 规 范 为 了 易于 区 分 、 归 类 流程 定义 所 设 ， 其 值 可 以 是 任意 文字 ， 当 然 一 般 由 公司 或 组 织 的 名 
称 定 义 ， 也 可 以 更 具体 到 一 个 项 目 ， 在 本 例 中 使 用 的 是 http://www.kafeitu.me/activiti-in-action， 本 书 所 有 的 targetrNamespace 也 均 使 用 来 声明 命名 空间 。 


代码 清单 2-2 中 的 #2 处 ， 定 义 了 id 属 性 为 leave 的 process 标 签 ， 以 此 来 标记 这 是 一 个 请 假 流 程 定义 的 开始 。 
代码 清单 2-2 中 的 #3 处 ， 定 义 了 流程 的 入 口 ， 即 空 启动 事件 startEvent， 当 流程 启动 时 总 是 以 startEvent 开 始 。 
代码 清单 2-2 中 的 #4 处 ， 定 义 了 流程 的 唯一 结束 出 口 ， 即 空 结束 事件 endEvent， 流 程 线 (flow) 执行 到 endEvent 时 表示 流程 结束 。 可 以 定义 多 个 结束 事件 。 


代码 清单 2-2 中 的 #5 处 ， 定 义 了 一 个 sequenceFlow 标 签 ， 用 来 描述 各 个 流程 节点 之 间 的 关系 。 图 2-6 中 的 箭头 线 就 是 sequenceFlow 所 定义 的 部 分 。sequenceFlow 用 sourceRef 表 示 从 哪里 开 


始 “ 流 ”到 哪里 。 


2.4.2 ”创建 单元 测试 类 


先 来 看 看 我 们 的 Java 类 代码 ， 如 代码 清单 2-3 所 示 ， 让 程序 运行 起 来 ， 然 后 再 解释 代码 的 含义 。 


代码 清单 2-3 ”最 简单 的 请 假 流程 的 Java 类 


public class VerySimpleLeaveProcessTest { 
@Test 
public void testStartProcess() throws Exception 
// 创建 流程 引擎 ， 使 用 内 存 数 据 库 
ProcessEngineprocessEngine = ProcessEngineConfiguration #1-S 
.CreateStandaloneInMemProcessEngineConfiguration () 
.buildProcessEngine(); #1-E 


// 部 署 流程 定义 文件 


RepositoryService repositoryService = processEngine.getRepositoryService(); #2 
repositoryService.createDeployment () #3-S 

.addClasspathResource ( 

"me/kafeitu/activiti/helloworld/sayhelloleave.bpmn.xml") .deploy (); #3 一 


// 验证 已 部 署 流 程 定义 
ProcessDefinitionprocessDefinition = repositoryService #4-S 
.CreateProcessDefinitionQuery() .singleResult () ， 


assertEquals ("leavesayhello", processDefinition.getKkey()); #4-E 

/ 局 动 流 程 并 返回 流程 实例 
RuntimeServiceruntimeService = processEngine.getRuntimeService(); #5 
ProcessInstanceprocessInstance = runtimeService #6-S 


.StartProcessInstanceByKey ("leavesayhello"); 

assertNotNull (processInstance); 

System.out.println ("pid=" + DrocessInstance .getId() + ", pdigd=" 
+ processInstance.getProcessDefinitionId()); 


#6 一 ] 


| 


} 
} 


下 面 对 代码 清单 2-3 中 所 有 标记 处 的 作用 依次 进行 解释 。 


#1-S 至 #1-E 是 通过 编程 方式 创建 一 个 流程 引擎 实例 ， 即 通过 ProcessEngineConfiguration 工 具 类 的 createStandalonelnMempProcessEngineConfiguration() 方 法 创建 一 个 使 用 H2 内 存 数 据 库 的 流程 
引擎 实例， 默认 的 JdbcUrI 为 jdbch2:mems:activiti。 当 然 ， 除 了 此 方法 之 外 还 有 其 他 创建 引擎 实例 的 方法 ， 例 如 调用 ProcessEngineConfiguration.createXXX().buildProcessEngine(0， 在 调用 过 程 中 还 可 
以 通过 编程 方式 配置 引擎 的 参数 ProcessEngineConfiguration.createXXX0Ohttp://www.hzcourse.com/resource/readBook? 


path=/openresources/teach ebook/uncompressed/15030/OEBPS/Text/..setFoo(argument).buildProcessEngine()。 
#2 处 紧 接 着 使 用 刚刚 创建 的 引擎 实例 获取 RepositoryService， 第 1 章 列 出 的 Activiti 的 七 大 Service 接 口 都 可 以 由 ProcessEngine 通 过 getXxxService() 方 法 获取 。 
#3 处 使 用 RepositoryService 部 署 位 于 classpath 中 的 流程 定义 文件 sayhelloleave.bpmn。 
#4-S 至 #4-E 处 用 来 验证 刚刚 部 署 的 流程 是 否 成 功 。 这 里 需要 说 明 一 下 ， 在 通过 七 大 Service 接 口 查 询 对 象 时 均 使 用 xxxService.createXxxQuery() 方 式 创建 查询 对 象 。 
#5 处 和 #2 处 一 样 ， 通 过 引擎 实例 获取 RuntimeService 对 象 。 


#6-S 处 使 用 runtimeService 启 动 一 个 流程 并 返回 流程 实例 。 此 外 runtimeService 和 创建 流程 引擎 的 方式 类 似 ， 也 提供 了 多 种 启动 流程 的 方式 ， 可 以 使 用 runtimeService.startProcessinstanceXxx0 启 动 
流程 实例 。 在 启动 的 同时 还 可 以 设置 流程 变量 ， 具 体 使 用 方法 可 以 先 参 考 API 文 档 中 的 方法 说 明 ， 以 后 的 章节 会 陆续 讲 到 根据 不 同 的 需求 使 用 不 同 的 启动 方式 。 接 下 来 验证 流程 是 否 启动 成 功 ， 这 仪 是 简单 的 
null 验 证 。 读 者 可 以 自行 扩展 验证 ， 以 验证 自己 的 猜测 结果 ， 这 也 是 一 种 很 好 的 学 习 方 式 。 最 后 输出 已 启动 的 流程 实例 的 ID 和 流程 定义 的 ID。 


2.4.3 运行 Hello World 


可 以 将 项 目 ppmn20-example 导 入 至 IDE， 笔 者 使 用 的 是 Eclipse IDE for Java EE Developers(Indigo)， 选 择 此 版 本 是 考虑 到 后 续 章节 中 有 基于 Web 的 应 用 。 本 书 的 例子 均 使 用 Maven 管 理 ， 在 实例 中 
已 配置 好 依赖 需要 使 用 的 仓库 (Repository) ， 通 过 http://www.eclipse.org/m2e/download/ 安 装 M2Eclipse 插 件 ， 然 后 单 击 菜单 : File->Import， 选 择 对 话 框 中 的 Maven-> Exsiting Maven Project 选 
项 ， 最 后 选择 本 示例 程序 所 在 目录 即 可 。 


使 用 JUnit 运 行 VerySimpleLeaveProcessTest 之 后 得 到 的 结果 是 : 
pid=5, pdid=leavesayhello:1:4 


pid 即 流程 实例 在 数据 中 的 jd; pdid 的 值 有 些 特殊 ， 由 一 些 列 参数 组 合 而 成 并 以 冒号 分 割 ， 其 中 leavesayhello 就 是 流程 定义 的 key，1 表 示 版 本 号 ，4 表 示 流 程 定义 在 数据 库 中 的 id。 


除了 使 用 Eclipse 运行 测试 用 例外 ， 还 可 以 在 命令 行 中 输入 myvn test 进 入 本 实例 目录 运行 。 


2.4.4 添加 业务 节点 


前 面 运行 了 最 简单 的 例子 来 说 明 流程 执行 过 程 (严格 来 说 不 是 一 个 流程 ， 因 为 根本 没有 做 任何 事情 ) ， 下 面 为 这 个 例子 添加 一 点 实际 业务 使 其 可 以 正常 工作 起 来 。 既 然 是 请 假 流 程 就 应 该 知道 是 哪个 员 
工 请 了 几 天 假 先 处 理 不 复杂 的 业务 信息 ) 。 


首先 需要 为 流程 添加 一 个 用 户 任务 (userTask) 来 处 理 申请 ， 根 据 申请 内 容 决 定 运行 申请 还 是 驱 回 申请 。 下 面 先 用 如 图 2-7 所 示 的 流程 图 来 表示 需求 。 


图 2-7 带 审批 的 请 假 流程 


然后 再 来 看 看 流程 定义 是 如 何 设计 的 ， 以 及 用 户 任 务 (userTask) 和 脚本 任务 是 如 何 定 义 的。 支持 领导 审批 的 请 假 流程 定义 如 代码 清单 2-4 所 示 。 


代码 清单 2-4 ”支持 领导 审批 的 请 人 


S 一 一 
和 流程 定义 


<?xml] version="] 
<definitions xmlns="h 


Xm] 


tp://www.omg .org/spec/l 
[Ins:xsi="http://www.w3.org/2001/XxM 


xmlns:bpmndi="h 
xmlns:omgdi="h 
expressionLang 
<process id="Say 


uage="ht 


tp://www.omg .org/spec/l 
tp://www.omg.org/spec/DD/20] 
tp://www.w3.org/1999/xPa 
HelloToLeave" name="SayHel] 


| .0" encoding="UTF-8"?> 


BPMN/20100524/MODEL" 
LSchema-instance" 
BPMN/20100524/D] 


00524/DI" 


typel 


oToLeave"> 


<S 


<userTask id=" 
<potenit 


usertaskl1" 
tialOwner> 


Language="ht 
th" targetNamespace="h 


xmlns:activiti="http://activit 
[" xmlns:omgdc="http://www.omg 


ti .org/bpmn" 
.org/spec/DD/20100524/DC" 


tp://www.w3.org/2001/XMLSchema" 


tartEvent id="starteventl" name="Start"></s 


nNanm 


"领导 审批 "> 


<resourceAssignmentExpression> 


< 


tartEvent> 


#1-S 


tp://www.kafei 


Expression> 


formalExpression>deptLeader</formalExpression> 
</resourceAssignment] 


</potentialOwner> 

</userTask> #1 一 EE 

<endEvent id="endeventl1l" name="End"></endEvent> 

<sequenceFlow igd="flowl" name="" sourceRef="starteventl1" 
targetRef="usertaskl"></sequenceFlow> 

<sequenceFlow igd="flow2" name="" sourceRef="outputAuditResult" 
targetRef="endevent1"></sequenceFlow> 

<scriptTask id="outputAuditResult" name=" 输 出 审批 结果 " #2-S 
scriptFormat="groovy"> 
<script><! [CDATA [ou 

</scriptTask> #2 一 

<sequenceFlow id="flow3" name="" sourceRef="usertaskl1" 
targetRef="outputAuditResult"></sequenceFlow> 


</process> 


</definitions> 


tu.me/activiti-in-action"> 


t:println "applyUser:" + applyUser + " ,days:" + days + ", approval:" + approved; ] ]></script> 


此 流程 在 2.4.1 的 基础 上 添加 了 新 的 userTask， 并 且 增 加 了 一 个 sequenceFlow 定 义 。 照 例 还 是 来 解释 一 下 此 流程 的 定义 。 


#1 处 使 用 userTask 来 定义 图 2-7 中 的 


deptLeader 角 色 的 人 员 都 可 以 处 理 此 任务 。 


“领导 审批 ”节点 ， 其 id 为 deptLeaderAudit， 在 其 内 部 使 用 BPMN 2.0 标 准 的 用 户 任 务 分 配 定 义 元 素 设置 了 此 任务 由 角色 为 deptLeader 的 人 员 处 理 ， 即 有 


#2 处 定义 了 通过 scriptTask 来 输出 “领导 审批 ”节点 的 处 理 结果 。 目 前 Activiti 支 持 的 scriptTask 类 型 有 Javascript 和 Groovy 两 种 。 本 例 使 用 可 以 运行 在 JVM 上 的 脚本 语言 Groovy 输 出 结果 ， 语 法 简洁 明 
了 ， 读 者 比较 容易 理解 。 在 scriptTask 标 签 内 部 定义 了 脚本 要 处 理 的 脚本 内 容 ， 由 script 标 签 包 囊 并 定义 为 CDATA 类 型 数据 。 在 流程 运行 的 过 程 中 Activiti 会 把 脚本 及 流程 变量 转交 给 Groovy 处 理 (需要 添加 
Groovy 的 jar 或 依赖 ) 。 


这 一 步 迈 得 好 像 有 点 大 了 ， 


务 的 作用 。 


h 


代码 清单 2-5 SayHelloToLeaveTest.java 


public class SayHelloToLeaveTest 


QTest 


public void testStar 


tProcess () 


throws 


t { 


Exception { 


Ms 


一 个 空 流程 突然 多 出 了 两 个 不 同 的 任务 ， 不 过 这 


ProcessEngineprocessEngine = ProcessEngineConfiguration 


.Creat 
Reposi 


eStandaloneInMemProcessgs] 


EngineCon 


figura 


toryServicerepositoryServic 


S 


reposi 


ring bpmnFileNam 


= "me/kaf 


itu/activi 


toryService.createDeploym 


tion () .buildProcess] 
processEngine.getRepositoryService(); 


ti/helloworld/SayHelloToLeave.bpmn"; #1-S 


nt () 


.addInputStream("SayHelloToLeave.bpmn ", 
.getResourceAsStream (bpmnF'i] 


ProcessDe 
.Creat 


ProcessD 


assertl 


LeName) ) .deploy (); 
finitionprocessDefiniti 


# 


this .getC] 


i 


一 下 


on 


repositoryService 


finitionQuery() .singleResult () ， 


Equals ("Say 


HelloToLeave", 


processDefinition 


‘getKey () ); 


Engine (); 


lass () .getClassLoader () 


RuntimeServiceruntimeService = processEngine.getRuntimeService();} #2-S 

Map<String, Object> variables = new HashMap<String, Object>(); 
variables.put ("applyUser", "employeel"); 
variables.put ("days", 3); 
ProcessInstanceprocessInstance = runtimeService.startProcessInstanceByKey ( 

"SayHelloToLeave", variables); #2-E 
assertNotNull (processInstance); 
System.out.println ("pid=" + DrocessInstance .getId() + ", pdigd=" 
+ processInstance.getProcessDefinitionId()); 

TaskServicetaskService = processEngine.getTaskService(); #3-S 

Task taskOfDeptLeader = taskService.createTaskQuery () 
.taskCandidateGroup ("deptLeader") .singleResult () ， 
assertNotNull (taskOfDeptLeader); 
assertEquals ("领导 审批 "，taskOfDeptLeader.getName () ) ; #3 
taskService.claim(taskOfDeptLeader.getId(), "leaderUser"); #4 
variables = new HashMap<String, Object>(); #5-S 
variables.put ("approved", true); 
taskService.complete (taskOfDeptLeader.get1Id(), variables); #5-FE 
taskOfDeptLeader = taskService.createTaskQuery () #6-S 
.taskCandidateGroup ("deptLeader") .singleResult () ; 
assertNull (taskOfDeptLeader); #6-EE 
HistoryServicehistoryService = processEngine.getHistoryService(); #7 
long count = historyService .createHistoricProcessInstanceQuery () .finished() 
.Count (); 
assertEquals (1, count); 


} 
} 


为 了 更 好 地 理解 代码 ， 在 开始 讲解 此 代码 清单 之 前 先 以 情景 模拟 的 方式 来 了 解 任务 的 签收 与 办 理 过 程 : 公司 的 每 个 部 门 可 能 有 多 个 领导 


#8 


两 个 任务 都 比较 简单 。 下 面 结合 代码 清单 2-5 的 单元 测试 代码 来 讲解 一 下 流程 ， 相 信 读 者 能 很 快 了 解 流程 的 运行 过 程 以 及 任 


(A 是 正 手 ，B 是 副手 ) ， 在 将 一 项 任务 分 配给 “部 门 领导 ”角色 


之 后 所 有 的 部 门 领导 都 会 收 到 一 条 未 签收 状态 的 任务 。 假 如 公司 约定 请 假 流程 的 审核 由 B 处 理 ， 在 申请 人 申请 请 假 之 后 A 和 B 同 时 会 看 到 一 个 需要 处 理 的 任务 (Task) ，B 签 收 任务 并 办 理 ， 此 时 A 的 待 办 任务 


列表 中 就 少 了 一 项 任务 。 本 来 


项 任务 是 属于 一 个 角色 或 某 几 个 候选 人 的 ， 在 执行 了 签收 动作 之 后 任务 归 签 收 和 所有。 在 了 解 对 任务 的 签收 和 办 理 的 执行 过 程 之 后 我 们 再 来 看 看 代码 清单 2-5 的 执行 过 程 。 


#1 处 和 代码 清单 2-3 的 #3-E 处 一 样 用 来 部 署 流程 ， 只 不 过 变换 了 一 种 方式 ， 不 是 直接 部 署 bpmn20.xml 而 是 部 署 以 bpmn 为 扩展 名 的 文件 。 原 因 解 释 一 下 : 这 个 流程 定义 是 通过 Eclipse Designer 创 建 


的 ， 默 认 扩展 名 为 bpmn (实际 内 容 是 一 样 的 ) ， 在 Activiti 5.9 以 及 之 前 的 版 本 中 流程 引 


擎 在 读 取 流 程 定义 文件 时 必须 以 bpmn20.xml 结 尾 ， 所 以 这 里 需要 变通 一 下 ， 在 部 署 流程 的 时 候 读 取 一 个 文件 流 并 由 


foo.bpmn20.xml 传 入 ， 结 果 和 代码 清单 2-3 中 部 署 bpmn20.xm| 一 样 。 从 Activiti 5.10 版 本 开始 Activiti 已 经 支持 直接 部 署 以 bpmn 扩 展 名 结尾 的 流程 定义 文件 。 


#2 处 与 代码 清单 2-3 中 的 启动 方式 稍微 有 些 差别 ， 在 调用 启动 流程 的 方法 中 传 入 了 一 个 Map 集 合 变 量 ， 


流程 的 时 候 会 把 这 两 个 变量 存 入 数据 库 中 ， 以 后 就 可 以 通过 接口 读 取 到 节点 。 


#3 处 的 任务 是 查询 组 (Group) deptLeader 的 未 签收 任务 并 验证 任务 的 名 称 。 


#4 处 通过 taskService 调 用 claim 方 法 “签收 ”此 任务 归 用 户 leaderUser 所 有 。 


这 里 设置 了 两 个 属性 ，applyUser 表 示 申 请 人 的 名 称 ，days 表 示 请 假 的 天 数 。 这 样 Activiti 在 启动 


#5 处 就 是 领导 的 处 理 结果 。 在 流程 启动 时 填写 了 请 假 人 与 请 假 天 数 来 模拟 实际 场景 ， 领 导 审 批 通过 ， 也 就 是 在 #5-S 处 设置 变量 approval 为 true 表 示 审 批 通过 ， 在 #5-E 处 完成 任务 的 同时 以 流程 变量 的 形 


式 设置 审批 结果 。 


#6 处 是 为 了 让 读者 更 好 地 理解 执行 结果 ， 因 为 任务 已 经 办 理 完成 ， 再 次 查询 组 deptLeader 的 任务 已 经 为 空 。 


#7 处 通过 流程 3 


擎 对 象 获取 历史 记录 碍 询 接口 。 


#8 处 通过 历史 接口 统计 已 经 完成 (finished) 的 流程 实例 数量 ， 接 着 验证 预期 的 结果 。 


细心 的 读者 可 能 会 问 : 明明 流程 图 中 有 两 个 节点 (领导 审核 和 输出 审批 结果 ) ， 为 什么 在 代码 中 没有 处 理 scriptTask 呢 ?在 讨论 这 个 问题 之 前 先 看 看 运行 结果 : 


pigd=5, pdid=SayHelloToLeave:1:4 
applyUser:employeel ,days:3, approval:true 


结果 中 第 一 行 和 代码 清单 2-3 执 行 结果 相同 ， 第 二 行 则 不 同 。 第 二 行 的 输出 是 scriptTask 执 行 的 结果 ， 在 流程 定义 中 用 Groovy 脚 本 输出 使 用 变量 拼接 的 信息 。 现 在 可 以 来 回答 刚刚 提出 的 问题 : 为 什么 代 
码 没有 处 理 scriptTask 呢 ?原因 很 简单 ， 对 于 scriptTask， 流 程 引 警 会 自动 处 理 ， 处 理 完 成 之 后 流转 到 下 个 节点 ， 在 本 例 中 scriptTask 之 后 就 是 结束 事件 了 ， 流 程 结束 ， 所 以 没有 处 理 scriptTask。 


就 目前 来 说 ， 除 了 userTask 不 能 被 自动 处 理 之 外 ， 其 他 的 任务 均 由 流程 引擎 自动 处 理 ， 无 需 人 工 参 与 。 


[1] 笔者 还 专门 买 了 一 件 印 有 Hello World 的 本 虱 。 


2.5 Activit! Explorer 
前 面 提 到 了 Activiti Explorer 是 Activiti 为 了 让 开发 人 员 快 速 入 门 所 设计 的 一 个 示例 程序 ， 本 节 将 介绍 如 何 运 行 Activiti Explorer 以 及 如 何 部 署 和 处 理 任务 。 


2.5.1 配置 并 运行 Activiti Explorer 


如 果 读 者 下 载 的 是 最 新 版 本 ， 那 么 直接 把 activiti-5.1x (5.11 及 之 后 的 版 本 ) 的 wars/activiti-explorer.war 复 制 到 一 个 干净 的 Tomcat 的 webapps 目 录 后 运行 Tomcat 即 可 。 如 果 需 要 运行 5.10 及 之 前 的 版 
本 ， 需 要 根据 下 面 的 步骤 依次 操作 。 不 管 运行 哪个 版 本 ， 最 后 启动 应 用 的 访问 路 径 看 到 如 图 2-8 所 示 的 界面 。 
现在 我 们 重新 回 到 Activiti 解 压缩 的 目录 ， 进 入 setup 目 录 ， 例 如 笔者 的 Activiti 解 压 目录 是 : /home/henryyan/work/sources/activiti/activiti-5.10/setup。 此 目录 中 有 几 个 子 目录 和 配置 文件 ， 下 面 依 


nr 
次 介绍 。 


.files: 此 目录 中 包含 运行 Activiti Exploretr 所 需要 的 一 些 配 置 文件 及 Web 应 用 ， 例 如 ，Tomcat 配 置 、 数 据 库 (H2) 初始 化 数据 、 所 需 的 jar 包 等 。 

.build.db.properties: 用 来 配置 数据 库 信 息 ， 通 过 配置 db 属性 可 以 使 用 其 他 的 数据 库 ， 例如 ，MySQL、Oracle、SQL Setvet 等 。 此 文件 中 还 有 jdbc 的 配置 信息 ， 可 以 通过 更 改 这 几 项 配置 来 使 用 本 地 数 
据 库 。 

build.properties: 用 过 Ant 的 读者 对 此 肯定 很 熟悉 了 ， 需 要 把 Ant 运 行 时 的 配置 信息 单独 配置 到 一 个 文件 。 此 文件 中 配置 了 运行 时 使 用 的 Tomcat 版 本 及 自动 文件 存放 位 置 。 


-build.xml: 配置 了 运行 、 停 止 、 清 理 等 目标 。 


\ 一 /一 


运行 Activiti Exporer 比 较 简 单 ， 只 要 使 用 Ant 执 行事 先 定 义 好 的 目标 即 可 。 现 在 通过 命令 进入 安装 目录 (activiti-5.x/setup) ， 执 行 命令 ant demo.start 即 可 自动 构建 、 运 行 目标 ， 并 且 在 完成 之 后 自 
动 打 开 浏 览 器 ， 访 问 地 址 为 : http://localhost:8080/activiti-explorer， 打 开 的 页 面 如 图 2-8 所 示 。 


© localhost:8080/activiti-explorer 


User ID 


Password 


图 2-8 Activiti Exploret 登 录 页 面 截图 


2.5.2 ”使 用 Activiti Explorer 


1. 登 录 系 统 


在 通过 Ant 脚 本 启动 Activiti Explorer 的 过 程 中 已 经 自动 初始 化 了 用 户 和 组 数据 ， 这 些 数 据 文件 位 于 activiti-5.x/setup/files/demo/h2.data.sql; 对 于 5.11 及 之 后 的 版 本 在 启动 Activiti Explorer 的 时 候 系 
统 会 自动 执行 数据 初始 化 工具 类 插入 初始 化 数据 。 


以 拥有 管理 员 角 色 的 用 户 kermit 登 录 系统 ， 默 认 密码 与 用 户 名 kermit 相 同 。 登 录 之 后 的 页 面 如 图 2-9 所 示 。 


人 > ACLIvIt Explorer 


€ 3 COlocalhostaos0/activitexplorerstasksategoryinbox OOVO 


人 


《> Activt Cxplorer ep a Kermitthe Frog ™ 


Process 


Inbox 加 My Tasks 回 Queued 加 Involved Archived 国 Events 
(Create new task.. J | 


BB Activiti.org. All rights reserved. 


图 2-9 登录 Activiti Explotret 之 后 的 页 面 截图 
2. 部 署 流程 


单 击 “Manage” 栏 目 ， 然 后 单 击 “Deployments” 菜单 选 择 “Upload new”， 弹 出 的 对 话 框 如 图 2-10 所 示 。 


Upload new deployment 


Select aflel.bar， .zp or .bpmmna0 .xml) or drop a fle n 
the rectangle below. 


图 2-10 在 Activit Exploret 中 部 署 流程 


前 面 设计 的 流程 SayHelloToLeave 需 要 在 启动 流程 时 设置 变量 ， 而 在 Activiti Explorer 中 为 了 简单 演示 笔者 采用 表单 (form) 形式 单独 设计 了 流程 定义 SayHelloToLeaveForActivitiExplorer。 单 
击 “Choose a file”， 然 后 在 文件 选择 对 话 框 中 选择 bpmn20-example/src/main/resources/me/kafeitu/activiti/helloworld/SayHelloToLeaveForActivitiExplorer.bpmn20.xml， 这 样 Activiti Explorer 
会 自动 部 署 流程 并 跳 转 到 流程 资源 查看 页 面 。 


部 署 流程 之 后 单 击 “Process” 栏 目 ， 在 左 侧 单 击 “SayHelloToLeaveForActivitiExplorer” 可 以 查看 流程 的 图 片 形 式 ， 此 图 片 由 引擎 自动 根据 xm 的 配置 信息 生成 。 但 是 很 不 幸 我 们 又 遇 到 了 让 人 邦 问 
的 乱码 问题 ， 如 图 2-11 所 示 。 


SayHelloloLeaveForActivitiExplorer 


| | Version 1 6G) Deployed moments ago 


Process Diagram 


图 2-11 在 Activiti Exploret 中 部 署 流程 后 的 中 文 乱码 


具体 解决 办 法 会 在 5.3.4 节 中 详细 介绍 。 现 在 可 以 再 次 部 署 ， 但 是 这 次 选择 SayHelloToLeaveForActivitiExplorer.zip 压 缩 包 ， 这 个 压缩 包 中 有 两 个 文件 : 
SayHelloToLeaveForActivitiExplorer.bpmn20.xml 和 SayHelloToLeaveForActivitiExplorer.png。 


重新 部 署 之 后 可 以 正常 显示 中 文 ， 如 图 2-12 所 示 。 注 意 划 线 处 的 Version 2， 它 表示 同一 个 流程 定义 部 署 了 两 次 ， 版 本 号 自动 累加 。 


SayHelloloLeaveForActivitiExplorer 


| | Version 2 G) Deployed moments ago 
Lhe Sl te 


Process Diagram 


图 2-12 ”部 署 SayHelloToLeaveFotActivitiExploret.zip 之 后 中 文正 常 显示 


3. 启 动 流程 


在 “Process” 栏 目 中 单 击 左 侧 的 “SayHelloToLeaveForActivitiExplore”， 然 后 单 击 页 面 右上 角 的 “Start process” ， 跳 转 到 启动 流程 表单 页 面 ， 如 图 2-13 所 示 。 


SayHelloloLeaveForActivitiExplorer 


[| Version 2 G) Deployed 10 minutes ago 


Apply User™ 


days”™ 


tprocess | | -Cancel 


图 2-13 ”启动 SayHelloToLeaveForActivitiExploret 流 程 页 面 


填写 Apply User 和 days 之 后 单 击 “Start process” 按 钮 即 可 启动 流程 。 


4. 签 收 与 办 理 任 务 


在 此 流程 中 ， 节 点 “领导 审批 ”被 设置 为 Management 组 。 当 前 登录 用 户 Kermit 拥 有 此 组 ， 所 以 在 启动 此 组 之 后 单 击 “Task” 栏 目 可 以 看 到 “Queued” 后 面 显示 数字 1， 表 示 当 前 有 需要 处 理 的 任 
务 ， 如 图 2-14 所 示 。 


图 2-14 ”Management 组 的 待 处 理 任务 


单 击 “Management(1)” 之 后 显示 任务 办 理 页 面 ， 其 中 包含 任务 的 名 称 、 任 务 所 属 人 及 表单 信息 ， 如 图 2-15 所 示 。 


People 中 | 
4 No owner ( Transfer ) 4 No assignee Reassign | 


Subtasks EE 
No subtasks defined for this task 


Related content + 


No related content attached for this task 
Fill in the foerm below and complete the task: 
ApPIY USET ot 


Approva 


图 2-15 ”任务 办 理 对 话 框 


我 们 已 经 了 解 了 签收 与 办 理 的 过 程 了 ， 现 在 单 击 “Claim” 按钮 之 后 任务 归 kermit 所 属 ， 之 后 就 可 以 审批 请 假 请 求 了 。 在 “Approval” 下 拉 框 中 选择 一 项 审批 结果 ， 如 图 2-16 所 示 。 


Related content 


No related content attached for this task 


Fill in the form below and complete the task: 


Approval*” | 同音 


| Complete task | Reset form 


图 2-16 ”选择 审批 结果 


选择 审批 结果 后 单 击 “Complete task” 即 完成 了 任务 的 办 理 。 此 流程 比较 简单 ， 仅 一 个 要 点 是 学 会 使 用 Activiti Explorer。 


2.6 本章 小 结 


本 章 从 下 载 Activiti 开 始 介 绍 ， 接 着 对 配置 JjDK、Ant、Maven 环 境 进 行 讲解 ， 然 后 在 此 基础 上 逐步 介绍 最 简单 的 Hello World 程 序 ， 紧 接着 又 进 阶 到 如 何 使 用 userTask 及 scriptTask， 并 且 利 用 单元 测试 
验证 所 的 期 望 结果 ， 最 后 就 如 何 运 行 Activiti Explorer 进 行 讨论 ， 使 读者 学 会 如 何 部 署 流程 并 解决 中 文 乱码 问题 ， 以 及 如 何在 Activiti Explorer 上 启动 、 签 收 、 完 成 任务 。 相 信 读 者 现在 已 经 对 Activiti 开 发 环 
境 有 了 一 个 大 体 的 了 解 ， 本 章 接触 到 的 启动 事件 、 结 束 事件 、 用 户 任务 、 脚 本 任务 只 是 BPMN 2.0 规 范 中 很 小 的 一 部 分 ， 下 一 章 我 们 将 学 习 Activiti 目 前 支持 的 BPMN 2.0 规 范 。 


二 部 分 “基础 篇 


在 第 一 部 分 中 用 两 章 内容 介 绍 了 Activiti 的 背景 知识 和 Activiti 入 门 ， 从 整体 上 对 Activii 有 了 初步 的 了 解 ， 讲 述 了 Activiti、 工 作 流 的 历史 ， 之 后 通过 简单 的 例子 讲解 如 何 使 用 Activiti API 驱 动 流程。 
本 部 分 内 容 都 是 后 续 章 节 的 基础 。 


第 3 章 涉 及 两 种 流程 设计 工具 Activiti Modeler 和 Activiti Designer， 分 别 适 用 于 业务 人 员 和 开发 人 员 ， 详 细 介 绍 了 这 两 种 工具 如 何 安 装 以 及 使 用 ， 尤 其 是 利用 Activiti Designer 和 JUnit 单 元 测试 帮助 读者 在 


Activiti 引 掌 基 础 上 更 好 地 理解 BPMN 2.0 规 范 。 
第 4 章 的 Activiti 与 BPMN 2.0 规 范 可 以 说 是 全 书 的 理论 基础 ， 讲 述 了 BPMN 2.0 规 范 中 模型 的 图 形 、XML 描述 和 Activiti 在 其 基础 上 的 扩展 。 有 兴趣 的 读者 可 以 结合 BPMN 2.0 规 范 的 官方 文档 目 辅 助 学 习 。 


[1] http://www.org/spec/BPMN/2.0/PDF/ 


第 3 草 流程 设计 工具 


前 面 两 章 我 们 首先 从 概念 上 介绍 了 工作 流 和 Activiti 的 背景 知识 ， 然 后 在 第 2 章 中 通过 日 常 办 公 中 请 假 的 例子 打开 了 Activiti 世 界 的 大 门 。 在 第 2 章 的 例子 中 提 到 的 流程 定义 文件 是 XML 格 式 的 ， 这 样 的 文件 


全 部 手工 来 写 肯 定 是 不 现实 的 ， 本 章 将 带领 读者 学 习 如 何 使 用 工具 拖 搜 的 方式 设计 流程 。 


Activiti 针 对 不 同 的 平台 提供 了 不 同 架 构 的 流程 设计 器 : 基于 B/S 架构 的 流程 设计 器 Activiti Modeler (可 以 通过 浏览 器 在 线 设计 流程 ) ， 基 于 Eclipse 插件 的 流程 设计 器 Activiti Designer。 


3.1 ”基于 B/S 架构 的 流程 设计 器 Activiti Modeler 


Activiti Modeler 是 基于 B/S 架构 的 流程 设计 器 ， 在 Activiti 5.11 版 本 发 布 之 前 Activiti 官 方 提供 了 独立 的 Activiti Modeler 组 件 ， 需 要 开发 人 员 执 行 压缩 包 中 的 脚本 打包 ， 但 是 从 Activiti 5.11 开 始 不 需要 
自行 打包 Activiti Modeler 了 ， 在 下 载 的 压缩 包 中 已 经 把 重新 设计 的 Activiti Modeler 集 成 到 了 Activiti Explorer 中 ， 所 以 不 想 了 解 如 何 打 包 的 读者 可 以 跳 过 本 节 内 容 。 关 于 重新 设计 的 Activiti Modeler 将 在 


3.2 节 介绍 。 
3.1.1 Activiti Modeler 特 点 


在 介绍 Activiti Modeler 之 前 不 得 不 先 介绍 一 下 Signavio， 它 是 Activiti Modeler 背 后 的 Signavio 开 源 BPMN 设 计 器 。Activiti Modeler 并 非 Activiti 官 方 开发 的 ， 而 是 基于 Signavio[1] 公 司 开发 的 
Signavio 构 建 的 。 


Singnavio 是 一 款 成 熟 BPMN 可 视 化 在 线 设计 器 ， 底 层 基 于 德国 的 HPI 公 司 开发 的 Web 的 建 模 工具 Oryx[ 站 。Signavio 昌 然 是 一 家 商业 公司 ， 但 是 它 提 供 了 遵循 MIT 协 议 开源 的 版 本 signavio-core- 


components。 


Signavio 公 司 同时 提供 了 商业 版 本 的 设计 器 以 满足 更 多 、 更 强 的 需求 ， 比 如 团队 协作 、 高 级 流程 设计 器 、 流 程 Portal、 分 析 与 报表 、 导 入 /导出 不 同 格式 的 文件 (ARIS、XPDL、PDF、Visio、Excel) 。 
当然 用 户 在 正式 购买 商业 版 本 之 前 有 30 天 的 试用 期 来 了 解 商业 版 本 的 功能 。 


Activiti Modeler 完 全 使 用 signavio-core-components 的 源码 构建 ， 而 且 在 打包 时 仪 需要 简单 的 配置 即 可 。 


名 说明 在 Activiti 5.6 及 之 前 的 版 本 中 ，Activiti Modelet 是 众多 组 件 中 的 一 部 分 ， 不 需要 我 们 自己 打包 Wat 文件， 有 兴趣 的 读者 可 以 下 载 Activiti 5.6 版 本 的 Zip 包 解压 一 下 看 看 。 
3.1.2 ”下载 signavio-core-components 


signavio-core-components 的 源码 托管 在 Google Code 上 ， 项 目地 址 : http://code.google.com/p/signavio-core-components/。 先 利用 版 本 控制 器 (Subversion) 检 出 源码 到 本 地 工作 区 。 有 
Subversion 客 户 端的 读者 可 以 利用 客户 端 方便 地 检 出 源码 ， 只 需要 在 URL 中 输入 http://signavio-core-components.googlecode.com/svn/trunk/ 即 可 。 喜 欢 使 用 命令 行 的 读者 可 以 执行 以 下 命令 : 


svn checkout http://signavio-core-components.googlecode.com/svn/trunk/ 


检 出 之 后 的 文件 列表 如 图 3-1 所 示 。 


ap'l 

configuration 

editor 

explorer 

libs 

platform 

platform extensions 
build.properties 
build.xml 

README 


LL 


图 3-1 ”signavio-corecomponents 目 录 结 构 


对 于 目录 中 的 文件 ， 我 们 只 关心 build.properties 和 build.xml 即 可 。 如 果 读 者 对 其 他 的 目录 文件 有 兴趣 可 以 逐个 浏览 ， 以 便 日 后 在 此 基础 上 进行 扩展 。 


3.1.3 ”配置 打包 与 运行 


build.properties 文 件 就 是 打包 时 需要 配置 的 一 些 选项 的 属性 文件 。 用 编辑 器 将 该 文件 打开 之 后 看 到 的 文件 内 容 如 图 3-2 所 示 。 

下 面 介绍 配置 文件 中 的 属性 及 其 含义 。 

. dif-tomcat-webabps: 运行 打包 结果 (wat 格 式 ) 的 tomcat 路 径 。 

.dit-jboss-webapps: 运行 打包 结果 (wat 格 式 ) 的 jboss 路 径 。 

' tafget: 存放 构建 结果 的 目录 ， 是 打包 之 后 生成 的 war 文 件 的 存放 位 置 。 

* version: 设计 器 的 版 本 号 ， 可 完全 由 用 户 自 定义 。 

war: 打包 的 wat 文 件 的 名 称 ， 例 如 activiti-modeler， 打 包 之 后 会 在 target 目 录 下 生成 activiti-modeler.wat 文 件 。 

“ configuration: 使 用 的 配置 ， 包 含 一 些 CSS 样 式 和 ]JSON 格 式 的 编辑 器 配置 。 目 前 支持 3 种 配置 : default、Activit、jBPM。 有 兴趣 的 读者 可 以 进入 到 configuration 目 录 一 探究 竞 。 
. host: 打包 之 后 运行 时 的 路 径 。 这 个 配置 很 关键 ,还 要 注意 仅仅 需要 提供 服务 器 地 址 (域名 或 IP) 及 端口 即 可 。 


“ fileSystemRootDirectory: signavio 运 行 时 的 工作 区 目录 ， 会 保存 编辑 器 的 配置 及 设计 的 流程 定义 文件 。 值 得 注意 的 是 ， 不 管 在 哪 种 操作 系统 环境 中 都 只 使 用 “/” 作 为 路 径 分 隔 符 。 


build.properties 其 


# This is the Signavio Core Components configuration file. Most users only have to configure this file. 


# The path to your Apache Tomcat webapps folder 
dir-tomcat—webapps = /apache—toncat-6.0.16/webapps 


# The path to your jBoss deployment folder 
dir-jboss-webapps = /jboss-5.1.0/server/default/deploy 


mn es 


# The folder the war file(ls) is/are stored 
target = target 


# The version of the application. lf You want to integrate the Signavio Core Components into 
# YOUr Own software product, youy can align the version number. 
Version=l1.@.@ 


# The name of the war file, if You use the all-in-one-war build target 
war = 5ignaviocore 


# The configuration You want to use. This is the name of the folder in the “conf1iguration project 
that contains the configuration and skin files, The following configurations are available: 
default, Activiti, jBPM 
You can also add your own configuration in the "configuration” project. 

configuration = default 

# The URL of your servers Format: http(s)://<domains>(:<port>) 

# Do not add a trailing slash here! 

host = http://Localhost:86888 


# The path on your system the directories and diagram files are created., 
# Do not use AN ! Always use / ! 
fileSsystemRootDirectory = Ci/repo 


图 3-2 ”build.properties 上 默认 配置 


了 解 了 配置 之 后 读者 就 可 以 根据 自己 的 实际 环境 更 改 配置 了 。 笔 者 只 更 改 了 几 个 属性 ， 其 他 属性 均 使 用 默认 值 。 


version=5.9 

war = activiti-modeler 

configuration = Activiti 
fileSystemRootDirectory=/Users/henryyan/workspaces/activiti-modeler 


了 解 到 这 里 读者 完全 可 以 基于 signavio-core-components 构 建 自己 的 流程 设计 器 ， 并 且 在 此 基础 上 进行 改造 ， 例 如 整合 公司 的 其 他 产品 、 功 能 扩展 以 及 本 地 化 等 。 


更 改 好 配置 之 后 只 需要 执行 ant build-all-in-one-wat 命 令 来 执行 打包 任务 ， 执 行 结果 如 下 : 


—henryyan@hy-mbp~/work/sources/signavio-core-componentsant build-all-in-one-war 
Buildfile: /Users/henryyan/work/sources/signavio-core-components/build.xml 

[war] Building war: 
/Users/henryyan/work/sources/signavio-core-components/target/activiti-modeler .war 
BUILD SUCCESSFUL 

Total time: 27 seconds 


执行 完 以 上 命令 后 我 们 可 以 看 到 在 signavio-core-components/target 目 录 中 生成 了 activiti-modeler.wat 文 件 ， 如 图 3-3 所 示 。 


api 
国 build 


晶 configuration 


让 | editor 


explorer 
libs 


i activitl-modeler.war 


dd platforrm 

| platform extensions 
页 build.properties 

a build,xml 
README 


| YF ¥ ¥ YF YY ¥ ™ 


图 3.3 ”打包 命令 的 执行 结果 
打包 之 后 复制 target/activity-modeler.war 到 本 地 Tomcat 的 webapps 目 录 ， 然 后 启动 Tomcat， 之 后 在 浏览 器 中 输入 http://localhost:8080/activiti-modeler 访 问 应 用 ， 加 载 页 面 如 图 3-4 所 示 。 


@ia 示 目前 Signavio 仅 支持 非 E 内 核 的 浏览 器 ， 例 如 Chrome、Firefox、Safati。 


Actvitri Modeler 
Powered by SIGNAVIO pp 


图 3-4 Activiti Modelet 的 加 载 页 面 
从 图 3-4 中 可 以 看 出 ， 图 片 使 用 的 是 configuration/Activiti 中 的 signavio_logo.png， 版 本 号 就 是 刚刚 在 build.properties 中 定义 的 version 属 性 。 


在 加 载 完 成 之 后 进入 Activiti Modeler 的 首页 ， 页 面 如 图 3-5 所 示 。 


图 3-5 Activiti Modelet 首 页 


本 节 是 针对 Windows 用 户 的 老话 题 一 一 乱码 。 


Windows 用 户 在 执行 a nt 的 打包 命令 ant budil-all-in-one-w at 时 会 遇 到 | 如 图 3-6 所 示 的 错误 言 息 。 


BUILD FAILED 
GMNWOPk™s1gnav1lio—core—components™ huild.xml:b4: lhe following error occurred wh1il 


ee ExeECUting this line: 
GWwork™“signavio-core—components veditor\huild.xml:119: Java returned: 2 


[otal time: 2 seconds 


图 3-6 Windows 环 境 下 打包 Activiti Modeler 报 错 


导致 构建 错误 的 原因 是 编码 不 一 致 ，Signavio 的 源码 采用 的 是 UTF-8 编 码 ， 而 中 文 版 本 的 Windows 操 作 系统 默认 的 编码 为 GBK， 编 码 不 一 致 导 致 在 转换 的 时 候 报错 。 笔 者 在 最 初学 习 Activiti 时 使 用 的 是 
Linux 操 作 系统 (Ubuntu[3]) ， 在 撰写 本 书 的 时 候 又 转向 了 Mac OS X 系 统 ， 因 为 Linux/UNIX 默 认 的 编码 是 UTF-8， 所 以 没有 遇 到 图 3-6 中 的 错误 。 


解决 办 法 分 三 步 ， 在 用 编辑 器 打开 signavio-core-components/editorvbuild.xml 文 件 进行 以 下 处 理 。 


1) 找到 <target name= “com.signavio.editorjs.concat”> ， 紧 随 其 后 添加 一 行 配置 代码 : 


<property name="charset" value="utf-8"/> 


将 标签 中 的 <concat destfile= ‘${build}/oryx.debug.js”> 修 改 为 : 


<concatdestfile='${build}/oryx.debug.js' encoding="${charset}" outputencoding= "${charset}"> 


最 终 的 配置 如 下 : 


<target name="com.signavio.editor.js.concat"> 


<property name="charset" value="utf-8"/> 
<concat destfile='${build}/oryx.debug.js' encoding="${charset}" outputencoding= "${charset}"> 


2) 找到 <target name='com.signavio.editor.js.compress 处 代码 ， 更 改 此 target 内 的 <java dir="${build}" jar="${root}ylib/yuicompressor-2.4.2.jar" fork= "true" failonerror= "true" 


output='${fcompress.temp} >， 将 其 中 的 yuicompressor-2.4.2.jar 更 改 为 yuicompressor-2.4.7.jar。 


3) signavio 默 认 使 用 yuicompressor-2.4.2 版 本 压缩 javascript 和 css 文 件 。 为 了 解决 编码 问题 我 们 需要 使 用 最 新 的 yuicompressor 版 本 来 替换 2.4.2 版 本 。 在 笔者 拟稿 时 最 新 的 yuicompressor 版 本 为 


2.4.7， 读 者 也 可 以 直接 下 载 最 新 版 本 。 访 问 http://yuilibrary.com/download/yuicompressor/ 下 载 第 一 个 版 本 的 压缩 包 ， 将 其 解压 后 提取 build/yuicompressor-2.4.7.jar 文 件 并 复制 到 signavio-core- 


components/yuicompressor/editor/lib 目 录 中 。 


再 次 执行 打包 命令 ant build-all-in-one-wat 不 会 提示 如 图 3-6 所 示 的 错误 提示 ， 如 图 3-7 所 示 。 


[copy] Gopying 2 files to G: “work™"“s1ignavio—core—components“ platform“target 
lasses 
[war] Building war: CG: Wwork™"“signavio—core—components“target “activiti—model 
BF ,WAP 


BUILD SUCGCCESSEFUL 
otal time: 28 seconds 


图 3-7 解决 了 Windows 环 境 下 打包 Activiti Modeler 错 误 后 的 提示 
3.1.5 ”设计 请 假 流 程 


首先 单 击 图 3-5 中 的 “New” 按钮 ， 然 后 选择 “Business Process Diagram(BPMN 2.0)” 新 建 一 个 流程 ， 此 时 浏览 器 会 打开 一 个 新 的 如 图 3-8 中 的 设计 器 页 面 。 


整个 设计 器 都 是 基于 Ext 的 拖 钨 方式 进行 操作 的 ， 如 图 片 3-8 所 示 。 其 中 左边 栏 是 模型 仓库 ， 中 间 部 分 是 工作 区 ， 右 边栏 可 以 用 于 设置 中 间 工 作 区 选中 模型 的 属性 ， 如 果 工 作 区 中 没有 选中 的 模型 ， 那 么 
右边 栏 可 以 用 于 设置 流程 主 信息 。 


在 第 2 章 中 已 经 初步 运行 了 请 假 流 程 ， 在 这 里 我 们 仍然 以 请 假 流 程 为 例 来 讲解 业务 需求 人 员 如 何 使 用 Activiti Modeler 从 业务 角度 设计 流程 。Activiti Modeler 设 计 的 请 假 流程 如 图 3-9 所 示 。 


《> Actvitri Modeler es SIGNAVIO 卢 


图 图 1 省 多 凸 其 1 司 居 1 量 旧 sml 4 人 怕 
Propertins (BPMN-Dingrarmm) 


本 Main attributes 
Collansed Subprocess 
Expanded subprocess 


; Collapsed Event-Subprocess + More attributes 


: Event Subprocess 

GHEY 

Slmlanes 

Artifacts 

Data Objects 

start Ewents 

Catehing Intermediate Events 
Throwing Intermediate Events 
Emd Events 

Conmecting Objects 


图 3-8 ”Activiti Modelet 的 新 建 流程 页 面 


图 3-9 ”Activiti Modeler 设 计 的 请 假 流 程 


一 个 完整 的 流程 总 是 以 开始 事件 (Start Event) 为 入 口 ， 在 Activiti Modeler 中 只 要 从 左 侧 的 模型 仓库 找到 “start Events”， 然 后 用 鼠标 将 其 拖 擅 到 中 间 的 空白 工作 区 中 。 开 始 事件 和 快捷 菜单 如 图 3- 
10 所 示 。 


当 将 鼠标 移动 到 圆 形 表示 的 “start Event” 时 会 出 现 一 些 快捷 菜单 图 标 ， 单 击 这 些小 图 标 可 以 快速 创建 各 种 模型 并 自动 用 顺序 流 箭头 连接 两 个 模型 。 


接 下 来 创建 “领导 审批 ”节点 时 可 以 单 击 空白 的 矩形 图 标 快速 创建 一 个 “Task (任务 ) ”; 也 可 以 从 左边 栏 的 “Activities” 中 拖 息 “Task” 到 空白 区 域 ， 然 后 把 鼠标 移动 到 “Start Event” 上 单 击 “区 
头 ”图 标 将 其 拖 灸 到 刚刚 创建 的 Task 模 型 上 。 在 日 常 的 使 用 中 还 是 第 一 种 方式 方便 得 多 ， 第 二 种 方式 只 有 在 特殊 情况 下 才 会 用 到 。 


了 解 了 如 何 创建 Task 之 后 就 可 以 使 用 第 一 种 方式 创建 “领导 审批 ”节点 了 。 图 3-11 展 示 了 通过 快速 方式 创建 的 Task。 


图 3-10 ”开始 事件 和 快捷 菜单 


图 3-11 通过 快速 方式 创建 的 Task 


有 了 Task 模 型 之 后 就 要 进一步 完善 Task 的 属性 ， 例 如 任务 名 称 、 类 型 等 。 设 置 属性 需要 展开 右边 栏 中 的 “Attributes”， 然 后 单 击 刚刚 创建 的 空白 Task， 在 右边 栏 中 设置 Task 的 相关 属性 即 可 。 在 图 3- 
12 中 设置 了 Task 的 “Name” 和 “TaskType”。 读 者 可 以 继续 添加 其 他 剩余 的 节点 并 设置 其 属性 。 


properties (Task) 


| Properties 


None 

: Send 

回 Recelve 
Py 

Cs Manual 

类 Service 

本 Business Rule 
昌 Script 


图 3-12 设置 领导 审批 节点 的 属性 


一 个 完整 的 流程 还 要 有 结束 事件 (End Event) ， 在 普通 的 Task 之 后 需要 有 一 个 结束 节点 。 结 束 节点 的 创建 方式 和 普通 Task 的 创建 方式 一 样 ， 将 鼠标 移动 到 需要 添加 结束 事件 的 任务 上 ， 然 后 单 击 粗 线 
条 的 圆 形 图 标 就 会 自动 创建 一 个 结束 事件 ， 如 图 3-13 所 示 。 关 于 各 种 事件 及 模型 会 在 第 4 章 详细 介绍 。 


| 


End Event = Click ordrag ] 


叶 画 而 通 画面 画 画 而 画面 夯 画 面 画 画面 另 画 面 曾 画 


图 3-13 ”创建 结束 事件 (End Event) 
到 此 一 个 完整 的 流程 就 设计 完成 了 ， 在 结束 之 前 不 要 忘记 保存 劳动 成 果 。 单 击 页 面 左 上 角 的 保存 按钮 ， 弹 出 如 图 3-14 所 示 的 对 话 框 。 
@i 在 填写 “Title” 字 段 时 不 要 输入 中 文 ， 否 则 会 导致 再 次 打开 流程 图 时 系统 报错 ， 提 示 找 不 到 页 面 (404 错 误 ) ， 报 错 信息 如 图 3-15 所 示 。 或 许 以 后 的 版 本 能 够 解决 次 问题 。 


保存 流程 之 后 可 以 在 Activiti Modeler 主 页 面 的 Workspace 中 看 到 流程 定义 ， 选 中 流程 定义 可 以 进行 编辑 、 移 动 、 复 制 、 删 除 等 操作 ， 如 图 3-16 所 示 。 


BPMN 2.0 


图 3-14 保存 流程 对 话 框 


Ar 
SS A 国 http: /i19e, 1b5.1. 104;6060/p/ publisher/roo 
文件 中 ) ”编辑 区) ”查看 WV) 收藏 来) 工具 (I) ”帮助 ) 


次 收藏 严 国 加 sche Tomcat/B.0.32 - Error report 


可 贞 ”页 面 E)， 安 全 GE)- I 具 @)， 人 @- ” 


HTTP Status 404 - /p/publisher/root-directory;%E8%AFWB7%ES5%81%87% 
E6%B5%81%0E7%0A89%08B.signavio.xml 


EB Status report 


messagel ublisher/root-directory:%E8%AF%B7%ES5%81%87W%E6%W%BS5%B81 WE7 WABYHB.signavio.xm 


ME The requested resource (/p/publisher/root-directory:%ES8%AF%B7% o819%68796E69%85968196E796A89%88.siqnavio.xml) is not available， 


ADache Tomcat/6.0.32 
图 3-15 ”打开 中 文 名称 的 流程 图 导致 404 错 误 


图 3-16 ”Activiti Modelet 主 页 面 的 Workspace 


3.1.6 ”导出 bpmn2.0.xml 


图 3-16 中 有 两 个 流程 定义 ， 一 个 是 英文 名 称 的 ， 一 个 是 中 文 名 称 的 。Activiti Modeler 的 设计 结果 都 以 xml 的 形式 保存 在 磁盘 上 ， 保 存 xml 文 件 的 目录 就 是 在 最 初 打 包 时 设置 的 fileSystemRootDirectory 
属性 值 。 例 如 笔者 的 设置 为 /Users/henryyan/work/workspaces/activiti-modeler， 打 开 该 目录 可 以 看 到 共有 4 个 文件 ， 如 图 3-17 所 示 。 


leave.bomn20.xml 
signavio.xml 


bpmn20.xml 
.signavio.xml 


图 3-17 流程 设计 文件 列表 


从 图 3-17 中 可 以 看 出 ， 每 个 流程 定义 都 有 两 个 文件 ， 只 不 过 扩展 名 不 同 。 其 中 “bpmn20.xml” 为 流程 定义 文件 ， 我 们 在 第 2 章 中 部 署 流程 的 时 候 使 用 的 也 是 扩展 名 为 bpmn20.xml 的 xml 文 
件 ; “signavio.xml” 文 件 用 于 保存 设计 流程 所 需要 的 一 些 配置 ， 其 中 配置 以 JSON 方 式 保存 在 leaven.signavio.xm| 文 件 的 “json-representation” 属 性 中 。 有 兴趣 的 读者 可 以 打开 流程 文件 阅读 其 中 的 配 
置 ， 本 书 不 深入 讨论 。 


[1] http:/ /www.signavio.com/ 
[2] http:/ /code.google.comy/P/otyx-editot/ 


[3] 一 个 很 流行 的 Linux 发 行 版 本 ， 可 从 http://www.ubuntu.com 上 下 载 。 


3.2 ”在 Activiti Explorer 中 使 用 Activiti Modeler 
从 5.11 版 本 开始 官方 提供 的 压缩 包 发 生 了 较 大 变化 (参考 2.1.1 节 ) : 把 重新 设计 的 Activiti Modeler 整 合 到 了 Activiti Explorer 中 ， 可 以 直接 创建 新 模型 然后 部 署 到 引 警 中， 也 可 以 根据 已 有 的 流程 定义 
创建 模型 ， 修 改 后 可 以 直接 把 最 新 的 修改 部 署 到 引擎 。 


人 @ 十 示 由 于 Activiti Modelet 组 件 需 要 依赖 REST 服 务 ， 因 此 读者 要 了 解 如 何 把 Activiti Modelet 集 成 到 自己 的 项 目 中 ， 相 关内 容 可 参考 20.8 节 。 


Activiti 5.11 版 本 之 后 的 Activiti Modeler 依 然 在 Signavio 的 基础 上 开发 ， 由 KISBPM[] 提 供 开 源 版 本 ， 同 时 KISBPM 也 提供 商业 版 本 支持 更 多 的 功能 ， 例 如 模型 的 版 本 控制 、 表 单 设计 器 、 自 定义 属性 、 
模板 库 、 模 型 部 署 、 角 色 控 制 等 。 


新 版 Modeler 移 除了 原 Signavio 对 于 其 他 规范 的 支持 (例如 BPM) ， 只 保留 Activiti 支 持 的 BPMN 2.0 规 范 ， 并 且 支 持 Activiti 扩 展 的 活动 以 及 属性 。 


把 压缩 包 中 提供 的 activiti-explorer.war 部 署 到 Tomcat 中 即 可 使 用 Activiti Modeler。 使 用 kermit/kermit 登 录 后 单 击 “Processes” 一 “Model workspace”， 即 可 看 到 如 图 3-18 所 示 的 页 面 (根据 系 
统 的 语言 不 同 界面 显示 的 语言 也 不 同 ， 笔 者 在 5.11 版 本 发 布 前 为 Activiti Explorer 添 加 了 国际 化 的 中 文部 分 ) 。 


© ActivitrExplorer z S$ nn 


Manage 


Processes 
息 
My instances Deployed process definitions | Model workspace [Ei| | : Model action: 是 


Copy model 
Delete model 


Demo modal | 模型 | 目 Depio 


Process Diagram 


图 3-18 ”模型 工作 区 


单 击 “New Model” 按 钮 后 打开 创建 模型 对 话 框 ， 如 图 3-19 所 示 。 


New mogel 


- NeWw model - 


Name* | 请 假 流程 


Description 


图 3-19 ”创建 新 模型 对 话 框 


新 版 设计 器 的 界面 和 老 版 本 一 致 (图 3-8) ， 如 图 3-20 所 示 。 
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图 3-20 ”新 版 Activiti Modelet 界 面 
从 左 侧 选 择 模 型 后 拖 动 到 工作 区 即 可 ， 单 击 模型 可 以 在 右 侧 设置 该 模型 的 属性 ， 如 图 3-21 所 示 。 


从 图 3-21 中 右 侧 部 分 可 以 看 到 有 表单 属性 (Form properties) 、 监 听 器 (Task listeners) 等 设置 。 


Properties (User task) 
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各 Main attributes 

ee Assignments ftotalCount… 1, "items": [Ca... 
hsynchronous NG 
Cardinality (Multikinatance) 


Colection [Multkinstance) 
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Documentation 

Element variable (Multiinatance) 
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Form key 
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Editor for a Complex Type 


Add 后 Remove 


Name 部 门 领导 审批 
Priority 
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Task lsteners 

2 More attributes 

ls for compensation tale 

Loop type None 


图 3-21 设置 模型 的 属性 


编辑 完 模 型 之 后 单 击 图 3-20 左 上 角 的 保存 按钮 保存 模型 ， 再 单 击 右 上 角 的 “X” 关闭 设计 器 返回 到 Activiti Explorer 中 ， 如 图 3-22 所 示 。 


i = 已 日 
©» ActivitiExplorer 人 
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Deployed process definitions 


Dermo model 
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站 Version 1 


部 门 领导 审批 


图 3-22 ”保存 模型 后 返回 到 Activiti Explorer 界 面 显示 设计 的 请 假 流程 


单 击 图 3-18 中 右上 角 的 “Deploy” 即 可 部 署 该 模型 ， 在 流程 定义 界面 就 可 以 看 到 刚刚 部 署 的 流程 定义 ， 如 图 3-23 所 示 。 


4《?ActivitiExplorer mw ”mo 
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图 3-23 ”从 模型 工作 区 部 署 的 流程 


[1] http://www.kisbpm.com/ 


3.3 ”基于 Eclipse 揪 件 的 流程 设计 器 Activiti Designer 


在 客户 的 需求 确定 之 后 ， 由 业务 人 员 利 用 Activiti Modeler 设 计 完 业务 流程 ， 此 时 可 以 将 设计 结果 导出 为 bpmn20.xml 文 件 ， 之 后 由 开发 人 员 继 续 基 于 设计 进一步 添加 涉及 技术 细节 的 配置 ， 例 如 排他 分 
支 的 条 件 、Java 服 务 、 任 务 监听 器 等 。 


3.3.1 Activiti Designer 特 点 


Java 程 序 员 每 天 工作 使 用 的 主要 工具 是 IDE， 而 应 用 最 广泛 的 IDE 当 然 是 Eclipse， 任 何 开 发 人 员 都 可 以 很 容易 地 开发 Eclipse 的 插件 。Activiti 目 前 提供 了 Eclipse 的 Activiti Designer 揪 件 ， 以 后 还 会 陆续 
推出 其 他 IDE 的 插件 ， 例 如 NetBeans、lntellJ IDEA 等 。 


Activiti Designer 一 般 随 着 Activiti 引 警 一 起 发 布 ， 在 Activiti 引 上 擎 的 新 版 本 添加 了 对 BPMN 2.0 规 范 的 支持 和 实现 之 后 ，Activiti Designer 也 同步 更 新 了 支持 新 规范 的 可 视 化 流程 设计 。 


相对 于 Activiti Modeler 严 格 以 BPMN 2.0 规 范 为 基础 实现 可 视 化 设计 ，Activiti Designer 提 供 了 Activiti 自 行 扩展 的 十 几 种 配置 (以 后 会 陆续 介绍 ) ， 例 如 使 用 activiti:assginee 简 化 UserTask 的 任务 办 
理 人 属性 ， 以 及 使 用 activiti:candidateGroup 简 化 任务 候选 组 等 。 


TDD (Test Driven Development， 测 试 驱动 开发 ) 被 广泛 用 于 日 常 开发 中 。Activiti Designer 当 然 也 为 TDD 提 供 了 良好 的 支持 : 开发 人 员 可 以 基于 流程 定义 文件 (foo.bpmn) 快速 生成 测试 用 例 ， 在 
设计 流程 的 时 候 把 存在 “ 坏 味道 ”的 业务 流程 停止 。 


3.3.2 ”安装 Activiti Designer 


本 书 使 用 的 Eclipse 版 本 为 4.2 (代号 Juno) ，Activiti Designer 支 持 3.7 (代号 Indigo) 以 后 的 Eclipse 版 本 。 


建议 读者 采用 Site 方 式 安装 Activiti Designer: 单 击 菜单 “Help”-> “Install New Software”， 打 开 如 图 3-24 所 示 的 对 话 框 。 然 后 单 击 “Add” 按 钮 ， 在 打开 的 对 话 框 中 填写 以 下 内 容 ， 接 着 单 
击 “OK” 按 钮 确认 添加 Repository。 


* Name: Activit BPMN 2.0designer 


Location: http://activiti.org/designer/update/ 


Install 


OD 
. 
O 


Available Software 


Select a site or enter the location of a site, 


Work with: | type or select a site 


type ie 


Details 
区 Group items by category 
[)] Show only software applicable to target environment 
[el Contact all update sites during install to find required software 


图 3-24 用 Site 方 式 添 加 Activiti Designer 的 Repository 


3.3.3 ”设计 流程 


1. 新 建 Activiti 项 目 


单 击 “File” 一 “New”， 选 择 图 3-25 中 的 “Activiti Project” 项 目 ， 单 击 “Next” 进 行 一 些 设置 之 后 就 可 以 创建 一 个 Activiti 项 目 。 


下 EE Activiti 


< Activiti Project 


Finish 


图 3-25 ”新 建 Activiti Project 向 导 


创建 完 项 目 后 的 目录 结构 如 图 3-26 所 示 ， 其 中 展示 的 是 一 个 名 为 “bpmn20-example” 的 项 目 ， 熟 悉 Maven 的 读者 很 快 就 看 出 这 是 Maven 的 标准 目录 结构 。 建 议 不 熟悉 Maven 的 读者 参考 Maven 的 文 
档 了 解 相关 知识 。 


新 建 的 Activiti 项 目 会 自动 在 src/main/resources 目 录 下 创建 diagrams 包 来 存放 新 建 的 流程 资源 文件 。 在 实际 应 用 中 往往 习惯 使 用 公司 或 组 织 域名 倒序 创建 目录 ， 如 图 3-26 所 示 。 


‘> bpmn20-example [activiti-in-action-codes rmaster| 
A Ei 
™ Ey main 
区 3 java 
V Ey resOurces 


TEyme 
™ Ey kafeitu 


下 ey activiti 
kb 区 W helloworld 
V Eytest 
bP Lojava 
bP Eresources 
es [otarget 
Mn) Pom.xml 


图 3-26 ”Activiti 项 目的 目录 结构 


2. 新 建 请 假 流程 


在 “src/main/resources/me/kafeitu/activiti” 目 录 上 右 击 ， 选择 “New” 一 “Other...”， 打 开 如 图 片 3-27 所 示 的 新 建 向 导 对 话 框 ， 选 择 “Activiti Diagram”， 单 击 “Next” 按 钮 弹出 如 图 3-28 所 
示 的 对 话 框 ， 其 中 默认 的 扩展 名 为 .bpmn， 也 是 众多 设计 器 默认 的 扩展 名 。 


全 提示 在 Activiti Designer 5.8 及 之 前 的 版 本 中 ， 在 新 建 流程 定义 时 默认 的 扩展 名 为 .activiti， 而 不 是 现在 看 到 的 .bpmn; 当 打 开 foo.activiti 文 件 设计 好 流程 并 保存 时 会 自动 在 同一 目录 下 生成 同名 的 
foo.bpmn20.xml 和 foo.pngo 


Select a Wizard 


Create a new Activiti BPMN 2.0 Diagram. 


type filter text 


bP [General 
WY BE Activiti 


< Activiti Project 
| EE: Connection Profiles 


图 3-27 新 建 Activiti Diagram 向 导 一 一 选择 新 建 类 型 


New Activiti Diagram 


Create a new Activitl BPMN 2.0 Diagram. 


Enter or select the parent folder: 


bpm nz20- example/s rc/main /resources me | kafeitu/ activiti 


再 > bpmn20-example [activiti-in-action-codes rmaster] 


Ey .Settings 
VY Ey Src 
™ By main 
多 :java 
VY Eresources 
Fs me 
™ [a kafeitu 


File name: 


图 3-28 新建 Activiti Diagram 向 导 设置 文件 名 


单 击 图 3-28 中 的 “Next” 按 钮 之 后 弹出 如 图 3-29 所 示 的 选择 模板 对 话 框 。 为 了 方便 快速 创建 流程 ，Activiti Designer 内 置 了 一 些 流程 定义 模板 供 开 发 人 员 选 择 。 在 创建 流程 之 后 开发 人 员 可 以 根据 自己 
的 需求 稍微 调整 即 可 。 


New Activiti Diagram 


Select the initial content for the new diagram. 


Do you want to add content to your diagram to start editing? 
I No, just create an empty diagram 


( ) Yes, import a BPMN 2.0 file 


【3 Yes, use a template 


Choose template 
IAdhoc Activiti Process 
Parallel Group Review And Approve Activiti Process 
Parallel Review And Approve Activiti Process 
Pooled Review And Approve Activiti Process 
Review And Approve Activiti Process 


| Cancel | 


图 3-29 ”新 建 Activiti Diagram 向 导 一 一 选择 模板 
人 @ 捉 示 在 安装 Activiti Designet 之 后 ， 在 任何 目录 都 可 以 通过 “New” 创 建 流程 定义 ， 前 面 关 于 创建 Activiti Project 的 介绍 仅仅 是 为 了 向 读者 说 明 创建 过 程 。 
3. 设 计 请 假 流程 
在 新 建 流程 之 后 要 先 设置 流程 属性 ， 例 如 Ild、Name 等 ， 设 置 请 假 流程 的 配置 信息 如 图 3-30 所 示 。 
下 面 介绍 配置 界面 中 的 几 个 属性 。 
. Id: 流程 的 唯一 标识 ， 在 2.4.2 节 中 启动 流程 时 指定 的 “leavehello” 即 此 属性 ， 建 议 使 用 纯 英 文 标识 。 


. Name: 流程 的 名 称 ， 可 以 是 任意 字符 。 


. Namespace: 命名 空间 ， 一 般 使 用 公司 名 或 组 织 域名 + 项 目 名 称 ， 可 以 更 加 细 化 到 每 个 系统 的 模块 ， 这 样 读者 在 实际 项 目 中 可 以 用 此 属性 来 归 类 流程 ， 例 如 com/company/ptoject/module ， 其 中 


com/company 是 公司 域名 的 倒序 ，project 表 示 项 目 名 称 ，module 表 示 一 个 具体 的 模块 ; 还 可 以 使 用 另外 一 种 描述 方式 ， 即 通过 http://www.compnay.com/project/module 达 到 相同 的 目的 。 


. Document: 针对 当前 流程 功能 的 简短 文字 描述 。 


. *Leave 器 | 


< 


一 SequenceFlow 


国 Properties 2 Problems 素 Ant 全 |ErrorLog 
ss 


Process ld leave | 


Name: : Leave 


Namespace: : http: / /www.activiti.org /test 


Docurmentation: 


图 3-30 ”设置 流程 属性 
和 Activiti Modeler 设 计 流 程 的 方式 一 样 ， 从 开始 事件 (Start Even) 开始 ， 在 设计 区 域 的 右边 栏 中 找到 “Event” 组 的 “startEvent” ， 用 鼠标 将 其 拖 动 到 左 侧 的 空白 区 域 ， 如 图 3-31 所 示 。 
图 3-31 中 “Properties” 下 的 Id、Name 的 含义 和 图 3-30 中 的 类 似 ， 只 不 过 这 里 表示 一 个 开始 事件 的 属性 。 


在 图 3-31 所 示 的 工作 区 中 ， 圆 形 图 标 即 为 开始 事件 ， 将 鼠标 移动 到 开始 事件 上 之 后 和 在 使 用 Activiti Modeler 时 一 样 会 浮动 显示 快捷 方式 菜单 ， 例 如 可 以 通过 单 击 左下 的 第 二 个 图 标 创 建 一 个 任务 
(Task) ， 如 图 3-32 所 示 。 


| 
~ 
/® 


| :oo re 


人 Create service task 

‘a) Create script task 

EI Create user task 

ul Create mail task 

本 Create business rule task 
fg Create manual task 

ED Create receive task 

[]) Create call activity 

的 Create exclusive gateway 
© Create inclusive gateway 
Create parallel gateway 
辐 Create end event 

wu Create error end event 

ws Create alfresco script task 


Create alfresco user task 
a Create alfresco mail task 


图 3-32 ”创建 开始 事件 


利用 快捷 菜单 可 以 快速 创建 各 种 模型 ， 当 然 也 可 以 直接 从 右边 栏 的 模型 仓库 中 选择 “Task” 拖 动 到 工作 区 。 单 击 “Create user task” 即 可 在 开始 事件 的 右边 生成 一 个 User Task 并 自动 用 顺序 流 
(SequenceFlow) 箭头 连接 ， 如 图 3-33 所 示 。 


Properties % 请， Problems 尖 Ant 9 ] Error Log 
| 
Ceneral ld: deptLeaveAudit 


Main config | i rm 
Listeners | Asynchronous: z 


Mulri instance Exclusive: 


图 3-33 ”通过 快捷 菜单 创建 User Task 


在 创建 “领导 审批 ”节点 后 单 击 刚刚 新 建 的 User Task 就 可 以 设置 属性 了 ， 在 图 3-33 中 将 ld、Name 属 性 设置 为 “deptLeaderAudit” 和 “领导 审批 ”， 前 者 是 Task 在 当前 这 个 请 假 流程 中 的 一 个 唯一 标 


识 。 


设计 “领导 审批 ”任务 在 使 用 Activiti Modeler 时 已 经 结束 了 ， 在 使 用 Activiti Designer 时 需要 进一步 设置 任务 的 属性 ， 例 如 任务 的 分 配 人 。 在 图 3-34 中 设置 “领导 审批 ”节点 的 分 配 人 为 “leader”. 


Y 人 可 


转 Properties 2 Bi Problems 凡 Ant BG]Error Log Unit 园 Console 


Cemeral Assignee: 


Main config 


~ Candidate users (comma separated): 
Form ] 


Listeners ] Candidate groups (comma separated: 


Multi instance : 
i rr key: 


图 3-34 设置 User Task 的 任务 分 配 人 


读者 可 以 自行 依次 完成 剩余 两 个 User Task 的 创建 与 设置 ， 如 图 3-35 所 示 。 对 于 在 设计 过 程 中 不 容易 理解 的 属性 在 以 后 的 章节 会 陆续 讲 到 ， 通 过 本 章 只 要 学 会 如 何 使 用 Activiti Designer 设 计 简单 流程 即 
可 。 


区 全 加 
二 一 
令 
/© 
[BB- 


图 3-35 ”使 用 Activiti Designer 设 计 完 成 的 请 假 流 程 


要 在 设计 完 流程 后 查看 XML 格式 的 文件 内 容 ， 需 要 右 击 foo.bpmn 文 件 选 择 “Open With” 一 “XML Editor”; 要 改 用 设计 器 打开 要 查看 的 文件 ， 需 要 右 击 foo.bpmn 文 件 选择 “Open 
With” 一 “Activiti Digram Editor”。 如 图 3-36 所 示 ， 图 中 上 半 部 分 使 用 “Activiti Digram Editor” 打 开 ， 下 半 部 分 使 用 “XML Editor” 打 开 。 


加 Leave.bpmn 中 


四 ?xmL version="1.0" encoding= "UTF-8"?> 
<definitions xmlns= "http://WWw. omg. Org/sSpec/BPMN/20100524/MODEL™ xmlns:xsi= http://WWw, Wi org/e00L/XML Sche 
SS <process id= "leave” name= "Legve"s 
<documentation> 请 假 流程 </documentation> 
startEvent id="startevent1™" name="Staort ></startEvent> 
<USerTOSK id="deptLeaoveAudit”name=" 贪 导 审 搓 " activiti:assignee="leader"></UserTask> 
<USerTOSK 1d="hrAudit ”nome= ,人事 审 梯 ”aactiviti:assignee= hr "></UuserTask> 
<UserTask id="reportBock” name=" 捕 假 ”activiti:assignee="${proposer} ></UserTask> 
<endEvent id= "endeventi1i" name= "End"></endEvent> 
sequUenceFlow id= "flowl” name="" sourceRef= storteventi1i” targetRef= "deptLeaveAudit ></sequenceF low> 
<seqUenceFlow id="flow2"” name="" sourceRef="deptLeaveAudit" targetRef="hrAudit "></sequenceFlows 
<seaquUenceFlow id="flow3" name="" sourceRef="hrAudit" targetRef="reportBaock"></sequenceF low> 
<sequUenceFlow id="flowt" name="" sourceRef="reportBack" torgetRef="endevent1l"></sequenceF low> 


Design |Source 


“Ur Leave 2 


图 3-36 ”使 用 不 同方 式 打 开 Leave.bpmn 文 件 


3.3.4 自动 化 
1. 自 动 生成 流程 图 片 
流程 图 可 以 帮助 用 户 快速 了 解 整个 流程 的 业务 逻辑 并 根据 不 同 的 条 件 采 用 处 理 方式 ， 在 流程 运行 过 程 中 可 以 以 图 片 形式 直观 体现 流程 状态 ， 例 如 标示 当前 在 哪个 节点 可 以 用 一 个 红色 的 边框 表示 。 
Activiti Designer 默 认 不 会 自动 生成 和 流程 相关 的 图 片 文件 ， 需 要 用 户 自行 更 改 插 件 的 配置 来 启用 自动 生成 图 片 功能 。 不 同 用 户 分 别 进行 如 下 操作 : 
. Windows、Linux 用 户 单 击 “Window” 菜 单 选择 “Preferences:…”。 
Mac 用 户 单 击 “Eclipse” 莱 单 选择 “Preferences:…”。 


打开 如 图 3-37 所 示 的 配置 对 话 框 。 依 次 选择 对 话 框 左 边栏 的 “Activiti” 一 “Save”， 勾 选 “Create process definition image when saving the diagram” 前 面 的 复 选 框 。 


Preferences 。 


| type filter text 


= Cemeral 
Activiti 
Alfresco settings Export marshallers 
Editor [el Create process definition image when saving the diagram 


Set preferences Used while saving Activiti Diagrams 


Save 
bb Ant 
Pb Data Management , Restore Defaults | 
bb Help 


| Cancel | 


图 3-37 设置 自动 生成 图 片 功 能 


单 击 “OK” 按 钮 ， 之 后 在 新 建 流程 或 在 原 有 流程 中 调整 任意 一 个 Task 并 进行 保存 即 会 在 流程 文件 的 同 目录 下 生成 同名 的 png 图 片 文件 ， 如 图 3-38 所 示 。 


MA > bpmn20-example lactiviti=in=action=codes master] 
TE > src 
TE > main 
3 java 
VEy> resources 
区 > me 
vey > kafeitu 


ys| 


b Eytest 
b [= target 
的 pom.xml 


图 3-38 ”自动 生成 的 和 流程 同名 的 图 片 文件 


2. 自 动 生成 测试 代码 


近 几 年 敏捷 开发 在 国内 的 企业 和 开源 社区 中 被 广泛 使 用 ， 其 中 和 开发 者 距离 最 近 的 当 属 极限 编程 (Extreme Programming，XP) ， 而 作为 XP 的 核心 原则 之 一 的 是 测试 驱动 开发 (Test Drive 
Development，TDD) 。TDD 能 让 代码 更 稳定 、 更 健壮 ， 使 所 有 的 新 功能 和 重 构 都 在 TDD 的 基础 上 进行 ， 把 Bug 扼 杀 在 开发 阶段 而 不 是 等 到 上 线 之 后 才 发 现 。 


Activiti 引 警 的 开发 也 是 使 用 TDD 进 行 的 ， 有 兴趣 的 读者 可 以 下 载 源码 来 阅读 ， 其 中 的 测试 用 例 履 盖 了 大 部 分 的 引擎 功能 。 同 时 Activiti Designer 也 为 日 常 开发 提供 了 便利 的 测试 驱动 的 功能 ， 使 开发 者 
可 以 很 方便 地 基于 流程 定义 文件 生成 对 应 的 单元 测试 。 


右 击 Leave.bpmn 选 择 “Activiti” 一 “Generate unit test” ， 如 图 3-39 所 示 。 


下 中 > bpmn20-example lactiviti=in=aciion=codes master) 
下 E > 5rc 

E> Main 

le2'Java 

> resources 
FE ~ Fe 
FT Gy > Kafeitu 
看 Ey > activiti 


Ey: = desigmer 


i 下 


时 New 到 


r rh Open ] 


he Open With 上 
EB POmMm. x ml 这 Copy ap ] 
3 Paste aby 

就 Delete 区 


Remove from Context 到 癌 归 4 

Mark as Landmark | 

Move... ] 

下 Rename... F2 

j= Outline ET Minlatul jy Import... | 


Sn outline 1s not avallable. EL Export... 


交 | Refresh F5 


Validate 
Show in Remote Systems view 
Run As 用 
Debug As 站 
profile As bb 
Compare With be 
Replace With bE 
3 
| 
kb 
用 


必 Properties 中 1 Problerms 


| Property 

| 理 |nfo 
Cerived 
edirable 
[last rnodified 
linked 


‘Denerate Unit test 


Path Tools 
Activiti 

Team 
SOUrce 


Properties 站 | 


We 一 一 一 ba meng ee J 


图 3-39 ”自动 生成 单元 测试 的 右键 菜单 


单 击 “Generate unit test” 之 后 会 在 “test/java/org/activity/designer/test” 包 中 生成 “ProcessTestLeave.java” 文 件 ， 如 图 3-40 所 示 。 


VE > bpmn20-example [activiti-in-action-codes master) 


Ey > Src 
Vv Ey > main 
E32'java 
TE > resources 
Ty> me 
Vv Ey > kafeitu 
Vv Ey > activiti 
VW E> designer 
bP «C5 Leave.bpmn 
加 Leave.png 
> [Er helloworld 
VEy> test 
Vv Ey > java 
bp By me 
下 区 3 > ofg 
下 区 3 > activiti 
VE > designer 
VW Ea'> test 


ProcessTestLeave.java 


Pb By resources 


图 3-40 ”自动 创建 的 单元 测试 类 
自动 生成 的 测试 代码 见 代 码 清单 3-1。 
代码 清单 3-1 Activiti Designer 自 动 生成 的 测试 代码 


package org.activiti.designer.test; 
// 省 略 了 import 部 分 


public class ProcessTestLeave { 


private String fi 
@Rule 
public ActivitiRule activitiRule = new ActivitiRule(); #1 
@Test 
public void startProcess() throws Exception { 
RepositoryService repositoryService = activitiRule.getRepositoryService(); #2 
repositoryService.createDeployment () .addInputStream( #3-S 
"leave.bpmn20.xml", new FileIinputSstream(filename)) .deploy (); #3 一 EE 
RuntimeService runtimeService = activitiRule 
.getRuntimeService (); #4-S 
Map<String, Object> variableMap = new HashMap<String, Object>(); 
variableMap.put ("name™", "Activiti"); 
ProcessInstance ProcessInstance = runtimeService.startProcessInstanceByKey ("leave", variableMap); #4 一 EE 


assertNotNull (processInstance.getId()); #5 
System.out .Println("id " + processInstance.getId() + " " 
+ DrocessInstance .getProcessDefinitionId () ) ， 


在 代码 清单 3-1 的 #1 处 创建 一 个 ActivitiRule， 通 过 实例 activitiRule 可 以 获取 第 1 章 中 提 到 的 7 个 Service 接 口 实例 ， 如 #2 处 获取 了 RepositoryService 


ename = "/Users/henryyan/work/books/activiti-in-action-codes/bpmn20-example/src/main/resources/me/kafeitu/activiti/designer/Leave.bpmn"; 


; 接 下 来 在 #3-S 至 #3-E 处 以 leave.bpmn20.xml 作 为 


文件 名 部 署 流程 ; #4-S 至 #4-E 处 和 代码 清单 2-3 类 似 ， 启 动 了 一 个 流程 实例 ; 最 后 在 #5 处 验证 流程 实例 processlnstance 的 id 属性 不 为 空 ， 进 而 证 明 流 程 启动 成 功 。 


有 了 单元 测试 类 就 可 以 用 来 验证 流程 的 设计 是 否 符合 预期 的 结果 ， 右 键 选择 “Run As' 一 “JUnit Test” 即 可 ， 如 图 3-41 所 示 ， 运 行 结果 如 下 : 


Aug 2, 2012 11:51:37 PM org.springframework.beans.factory.xml .XmlBeanDefinition-Reader loadBeanDefinitions 
INFO: Loading XML bean definitions from class path resource [activiti.cfg.xmll] 

Aug 2, 2012 11:51:39 PM org.activiti.engine.impl.db.DbSqlSession executeSchemaResource 

INFO: performing create on engine with resource org/activiti/db/create/activiti.h2.create.engine.sql 

Aug 2, 2012 11:51:39 PM org.activiti.engine.impl.db.DbSqlSession executeSchemaResource 

INFO: performing create on history with resource org/activiti/db/create/activiti.h2.create.history.sgl 
Aug 2, 2012 11:51:39 PM org.activiti.engine.impl.db.DbSqlSession executeSchemaResource 


P 
INFO: Performing create on identity with resource org/activiti/db/create/activiti. h2.create.identity.sql 
Aug 2, 2012 11:51:39 PM org.activiti.engine.impl.ProcessEngineImpl <init> 
P 
Ip] 


INFO: ProcessEngine default created 
Aug 2, 2012 11:51:39 PM org.activiti.engine.imp] 
INFO: Processing resource leave. bpmn20 .xml 
Aug 27 .2012 :51:39 PM org.activiti.engine.impl.bpmn.parser.BpmnParse parseDefinitionsAttributes 
INFO: XMLSchema currently not supported as typeLanguage 
Aug 2, 2012 11:51:39 PM org.activiti.engine.impl.bpmn.parser.BpmnpParse parseDefinitionsAttributes 
INFO: XPath currently not supported as expressionLanguage 

id 5 leave:1:4 


.bpmn .deployer .BpmnDeployer deploy 


VW 区 3 > activiti 
可 区 > designer 
和 区, > test 
a ProcessTestLeave.java 


New » LvitiRule activitiRule = new Activi 


Open 

Open With bh. 1 startProcess() throws Exception 
EoryService repositoryService = Oct 

| 本 Copy | toryService. craataDeploymentt ) .addI 

Winiature View pacte 人 new FileInputstream(filename)). de 
EService runtimeService = activitiR 

其 Delete ring, OQbject> variableMap = new Hos 
iti.designer.test leMap .put(C"name", "Activiti"): 
estLeave % Remove from Context OO slInstance processInstance = runtime 


EsOQUTCES 


me : String | Mark as Landmark Cet NotNull(processInstance.getId()); 
iRule : ActivitiRule 
rocess0) : void 


Move... 
Rename... 


gj IMmport... 
E33 Export... 


Error LO JUnit 


S| Refresh 


Validate 
Show in Remote Systems view 


- 1 JUnit Test 


图 3-41 运行 单元 测试 


读者 可 以 通过 自动 生成 测试 代码 功能 来 学 习 Activiti， 当 想 了 解 Activiti 如 何 处 理 一 个 流程 组 件 时 可 以 先 设计 一 个 流程 定义 ， 然 后 生成 单元 测试 代码 ， 利 用 Junit 的 功能 验证 引擎 运行 的 结果 是 否 和 预期 一 
致 。 


3.3.5 ”升级 历史 遗留 的 流程 设计 


第 2 章 的 Hello World 是 在 部 署 XML 格 式 的 文件 之 后 启动 流程 的 。 使 用 Activiti Modeler 设 计 的 流程 定义 会 在 工作 区 生成 两 个 文件 : foo.ppmn20.xml 和 foo.signavio.xml， 这 两 个 文件 的 作用 前 面 已 经 讲 
到 了 ， 这 里 不 再 重复 。 那 么 在 Activiti Designer 中 如 何 生 成 foo.bpmn20.xml 文 件 呢 ? 


答案 很 简单 ， 用 于 设计 流程 的 oo.bpmn 文 件 就 是 我 们 想 要 的 foo.bpmn20.xml， 为 什么 这 么 说 呢 ?” 这 既是 业界 的 约定 ， 也 有 一 定 的 历史 原因 。 
bpmn 是 BPMN XML 文件 的 默认 扩展 名 。 很 多 设计 器 都 使 用 bpmn 作 为 流程 定义 文件 的 扩展 名 。 


Activiti Designer 5.8 及 之 前 的 版 本 是 将 .activiti 作 为 设计 文件 存在 ， 在 保存 foo.activiti 之 后 会 自动 生成 foo.bpmn20.xml 和 foo.png 两 个 文件 。 之 后 在 Activiti Designer 5.9 版 本 发 布 时 放弃 了 这 一 做 法 改 
用 标准 的 .bpmn 作 为 扩展 名 ， 同 时 不 会 再 生成 foo.bpmn20.xml 文 件 ， 因 为 新 的 .bpmn 文 件 内 容 和 Activiti Designer 5.8 版 本 之 前 自动 生成 的 oo.bpmn20.xml 文 件 内 容 一 样 。 


升级 Activiti Designer 5.8 及 之 前 版 本 的 设计 文件 至 兼容 新 版 本 的 步骤 如 下 : 
1) 删除 .activiti 文 件 ， 不 再 需要 它 了 。 


2) 重 命名 foo.bpmn20.xm| 为 foo.ppmn， 刚 刚 已 经 提 到 到 ， 文 件 内 容 相 同 ， 仪 仪 是 扩展 名 不 同 而 已 。 
3.3.6 ”导入 Activiti Modeler 设 计 


在 3.1 节 中 了 解 了 如 何 使 用 Activiti Modeler 设 计 流 程 ， 并 且 也 看 到 了 生成 的 leave.bpmn20.xml 文 件 ， 现 在 假设 业务 流程 设计 已 经 完成 ， 要 将 其 转移 给 开发 人 员 进 行 完善 以 满足 引擎 运行 的 要 求 。 


把 Activiti Modeler 工 作 区 中 的 leaven.bpmn20.xm| 复 制 到 项 目 中 ， 将 其 重 命名 为 leave.bpmn， 双 击 leave.bpmn 就 可 以 以 设计 器 方式 将 其 打开 以 便 更 改 流 程 配置 ， 如 图 3-42 所 示 。 


sid-128f9b3b-c17e-4654-934f-c645bl7b926b 


Name: leave 
http:/ /www.signavio.com/bpmn20 


Namespace: 


Documentationm: 


图 3-42 ”将 使 用 Activiti Modeletr 设 计 的 流程 定义 导入 至 Eclipse 工程 中 
息 ， 例 如 可 以 将 一 长 串 的 字符 表示 的 流程 的 ID 属性 更 改 为 leave， 完 成 之 后 同样 可 以 生成 单元 测试 功能 来 验证 更 改 是 否 正 确 。 


至 此 可 以 执行 像 3.3.3 节 “设计 流程 ”那样 的 过 程 来 完善 流 


3.3.7 ”泳池 与 泳 道 
图 3-43 是 一 个 常见 的 标准 游泳 池 ， 一 个 泳池 (Pool) 中 分 为 了 多 个 泳 道 (Lane) ， 比 赛 时 每 一 个 参赛 选手 只 能 在 自己 的 泳 道中 前 行 。 


图 3-43 ”游泳 池 


只 能 ， 就 会 使 用 泳池 与 泳 道 来 划分 。 


相信 有 一 部 分 读者 使 用 过 Viso 或 类 似 的 工具 来 设计 流程 ， 为 了 沟通 方便 和 清晰 展示 不 同 角色 、 岗 位 人 员 的 职能 ， 
回想 一 下 请 假 流程 中 的 设计 ， 涉 及 的 人 员 角 色 分 别 有 : 员工 、 部 门 领 导 、 人 事 ， 在 BPM N 2.0 规 范 中 请 假 流 程 还 可 以 这 么 来 设计 ， 如 图 3-44 所 示 


图 3-44 ”请 假 流 程 的 泳 道 模 式 


读者 可 以 把 前 面 章节 接触 到 的 请 假 流 程 与 图 3-44 进 行 对 比 ， 显 然 图 3-44 中 的 泳 道 模式 会 更 加 直观 、 清 晰 地 划分 出 不 同 角色 、 职 能 人 员 所 需要 负责 的 任务 。 
图 3-44 中 包含 了 一 个 泳池 (名 称 为 : 请 假 流程 ) 以 及 3 个 泳 道 (员工 、 领 导 、 人 事 ) 。 
3.3.8 在 Activiti Designer 中 使 用 泳 道 与 泳池 


新 建 一 个 流程 ， 然 后 在 打开 的 设计 窗口 右 侧 选择 “Container” 栏 中 的 “Pool” 并 拖 动 到 空白 区 域 ， 如 图 3-45 所 示 。 


[二 Container 


EventSubProcess 


subProcess 


图 3-45 ”从 工具 栏 中 选择 泳池 与 泳 道 


拖 动 完成 后 即 创建 了 如 图 3-46 所 示 的 泳池 ， 此 时 可 以 单 击 泳池 左 侧 (Pool 文 字 处 ) 选中 泳池 以 编辑 其 属性 ， 如 图 3-47 所 示 ， 把 泳池 的 名 称 改 为 “请 假 流 程 ”。 


Pool 


图 3-46 ”只 包含 一 个 泳 道 的 泳池 


1 Markers 国 Properties 点 Servers 上 


General 
Process 


图 3-47 编辑 泳池 的 属性 


单 击 图 3-46 中 的 泳 道 同样 可 以 编辑 属性 ， 把 第 一 个 泳 道 命名 为 “员工 ”用 来 存放 和 请 假 申 请 人 有 关 的 任务 ， 如 图 3-48 所 示 。 


接 下 来 就 可 以 像 前 面 章节 一 样 来 设计 流程 ， 在 “员工 ” 泳 道中 拖 动 一 个 启动 事件 ， 如 图 3-49 所 示 。 


| 


Data Source Explorer 


leavePool | 


图 3-48 选择 并 编辑 泳 道 属性 


图 3-49 在 员工 泳 道中 拖 入 一 个 空 启动 事件 


接 下 来 需要 再 创建 一 个 针对 领导 的 泳 道 ， 在 右 侧 工具 栏 选 择 “Container” 中 的 “Lane” 拖 动 到 泳池 中 ， 如 图 3-50 所 示 。 


中 


| 


由 
= 
四 
衬 
中 
本 


图 3-50 创建 了 一 个 新 的 泳 道 
以 此 类 推 读 者 就 可 以 设计 出 如 图 3-44 所 示 的 流程 图 。 


物理 的 泳池 只 能 划分 固定 数量 的 泳 道 ， 在 设计 流程 图 时 对 泳 道 的 数量 没有 限制 ， 可 以 由 任意 多 个 泳 道 组 成 一 个 大 的 泳池 ， 所 以 泳 道 与 泳池 常 在 一 些 相 对 复杂 的 流程 中 使 用 。 


3.4 ”本 章 小 结 
“ 工 欲 善 其 事 ， 必 先 利 其 器 ” 。 本 章 主要 介绍 了 Activiti 引 擎 提供 的 两 个 流程 设计 器 ， 一 个 是 由 Signavio 授 权 的 基于 Web 的 Activiti Modeler， 另 外 一 个 是 Activiti Designer。 两 个 设计 器 侧重 面 不 
同 ，Activiti Modeler 偏 向 于 业务 层面 ， 而 Activiti Designer 则 更 侧重 于 开发 层 。 


针对 Activit Modeler 本 章 讲解 了 如 何 进行 打包 、 部 署 、 运 行 等 ， 并 且 简 单 介 绍 了 如 何 使 用 Activiti Modeler 设 计 一 个 简单 的 请 假 流 程 。 针 对 Activiti Designer 本 章 详细 讲解 了 安装 插件 、 设 计 流 程 、 自 动 
生成 图 片 和 单元 测试 代码 等 内 容 ， 又 介绍 了 针对 历史 原因 致使 流程 定义 文件 扩展 名 不 同 而 进行 的 升级 设计 ， 最 后 介绍 了 从 业务 层 向 开发 层 导入 流程 定义 文件 的 方法 。 


有 了 对 流程 引 警 的 初步 认识 及 使 用 工具 设计 流程 的 基础 ， 对 于 下 一 章 将 详细 介绍 的 目前 Activiit 支 持 的 BPMN 2.0 规 范 ， 读 者 可 以 借助 Activiti Designer 更 好 地 学 习 。 


第 4 章 ”Activiti 与 BPMN 2.0 规 沁 


理论 是 实战 的 基石 ， 因 此 详细 了 解 Activiti 支 持 的 BPMN 2.0 规 范 显得 格外 重要 ， 尤 其 是 对 前 面 章 节 示 例 中 的 模型 定义 不 太 了 解 的 读者 更 要 了 解 BPMN 2.0 规 范 。 


BPMN 2.0 规 范 包含 很 多 种 模型 。 目 前 Activiti 可 以 支持 在 大 多 数 情 况 下 常用 的 模型 ， 并 且 在 实现 规范 的 基础 上 进行 了 功能 和 使 用 性 扩展 。 在 讲解 的 过 程 中 首先 会 介绍 BPMN 2.0 规 范 中 的 定义 方式 ， 如 
果 Activiti 添 加 了 扩展 属性 、 配 置 ， 也 会 介绍 其 合 义 及 配置 方法 。 


本 章 每 一 节 将 按照 概念 、 图 形 、XML 描 述 、 实 例 讲 解 及 Activiti 的 扩展 属性 的 顺序 进行 讲解 ， 理 论 结合 实例 使 读者 快速 对 BPMN 2.0 规 范 有 一 个 全 面 的 认识 ;有 BPMN 2.0 规 范 基础 的 读者 可 以 了 解 
Activiti 针 对 BPMN 2.0 规 范 的 封装 及 扩展 ， 借 助 Activiti 的 扩展 功能 可 以 更 方便 地 实现 和 BPMN 2.0 规 范 中 相同 的 功能 ， 并 且 通 过 简单 配置 即 可 实现 邮件 任务 、Java Service 任 务 等 不 在 BPMN 2.0 规 范 之 内 的 


本 章 内 容 根据 BPMN 2.0 规 范 的 分 类 划分 为 以 下 几 部 分 : 
启动 与 结束 事件 (Event) 

: 闫 库 流 (Sequence Hlow) 

* 任务 (Task) 

"i 

. 子 流程 (Subprocess) 

. 边界 事件 (Boundary Event) 

. 中 间 事 件 (Intermediate Event) 


: 监听 器 (Listener) 


过 说 明 本章 内 容 结 合 了 BPMN 2.0 规 范 和 Activiti 在 其 基础 上 的 封装 与 扩展 ， 以 activiti: 开 头 的 XML .元素 或 属性 都 是 Activiti 在 BPMN2.0 基 础 上 添加 的 ， 其 他 均 为 BPMN2.0 规 范 所 定义 的 。 


4.1 ”启动 事件 与 结束 事件 


启动 事件 与 结束 事件 作为 BPM N 2.0 规 范 中 很 重要 的 一 部 分 ， 分 别 负责 一 个 流程 的 开始 和 结束 。 一 个 完整 的 流程 可 以 分 为 两 大 类 : 启动 事件 、 结 束 事件 。 每 一 个 大 类 又 可 以 根据 功能 不 同 分 为 多 个 小 


类 。 


所 有 的 开始 事件 均 以 如 图 4-1 所 示 的 细 线 圆 形 为 基础 。 本 节 讲解 的 其 他 事件 都 是 在 其 基础 上 “嵌入 ”对 应 类 型 的 图 形 来 表示 一 种 启动 事件 的 。 


图 4-1 启动 事件 的 基本 图 形 


所 有 的 结束 事件 均 以 如 图 4-2 所 示 的 粗 线 圆 形 为 基础 。 本 节 讲 解 的 其 他 事件 都 是 在 其 基础 上 “嵌入 ”对 应 类 型 的 图 形 来 表示 一 种 结束 事件 的 。 


图 4-2 ”结束 事件 的 基本 图 形 


每 个 流程 总 是 以 启动 事件 作为 入 口 〈 可 以 是 不 同类 型 的 启动 事件 ) 。 启 动 事件 在 BPMN 2.0 规 范 中 以 一 个 细 线 贺 形 图 形 表示 ， 如 图 4-1 所 示 。 启 动 事件 又 可 以 分 为 以 下 三 种 类 型 
. 空 启动 事件 

. 定时 启动 事件 

. 异常 启动 事件 


启动 事件 都 是 “捕获 型 ”的 ， 等 待 第 三 方 触 发 后 (读者 可 以 联想 一 下 观察 者 模式 ) 才 可 以 启动 。 在 Activiti 中 可 以 通过 调用 APl 和 触发 启 动 事件 ， 在 Hello World 示 例 中 就 是 通过 调用 
runtimesService.startProcesslnstance() 方 法 触发 来 启动 一 个 流程 实例 的 。 


1. 空 启动 事件 
图 4-1 展 示 了 空 启 动 事件 的 图 形 化 表示 ， 对 应 的 XML 描述 如 代码 清单 4-1 所 示 。 


代码 清单 4-1 ” 空 启动 事件 的 XML 描 述 


<startEvent id="startEvent" name="Start event" ></startEvent> 


在 代码 清单 4-1 中 用 表示 一 个 启动 事件 ， 由 于 startEvent 标 签 中 没有 任何 其 他 的 元 素 定义 ， 所 以 称 之 为 空 启动 事件 ， 这 也 是 其 他 启动 事件 的 XML 基 本 表示 。 


Activiti 根 据 实际 需求 在 空 启 动 事件 的 基础 上 进行 了 扩展 。 表 4-1 列 举 了 Activiti 扩 展 的 空 启动 事件 属性 。 


属性 名 称 


activiti:formKey 


activiti:initiator 


表 4-1 Activiti 扩 展 的 空 启动 事件 属性 


属性 说 明 


Activiti 扩展 的 formKey 属性 ， 可 
以 用 来 指定 空 启动 事件 关联 的 表单 
文件 。 关 于 如 何 设置 关联 表单 将 在 

AN 


Ps pn 
后 加 草 卫 个 组 


Activiti 扩展 的 initiator 属性 ， 可 
以 用 来 记录 启动 流程 的 人 的 ID (也 


四 以 是 用 户 的 名 称 )， 局 动 流程 之 后 


此 属性 指定 的 变量 就 会 自动 设置 当 
亲人 的 名 称 


不 例 


<startEvent 1d="startEvent" activiti: 
formKey="apply.form" /> 


<startEvent 1d="startEvent" activltl:Inltla- 
tor="startUserld" /> 

在 流程 流转 中 就 可 以 通过 获取 变量 
startUserId 得 到 局 动 时 操作 人 ID 


除了 以 上 属性 之 外 ， 还 可 以 在 空 启动 事件 上 定义 表单 属性 ， 同 样 在 用 户 任务 上 也 适用 。 启 动 事件 可 以 配置 相关 表单 ， 引 擎 提供 了 外 置 表单 和 动态 表单 两 种 表单 形式 。 为 了 后 面 更 好 地 理解 这 两 种 表单 ， 


先 简单 介绍 这 两 种 表单 的 区 别 。 


. 外 置 表单 : 表单 的 内 容 都 存放 在 一 个 单独 的 “.form” 文 件 中 ， 可 以 是 任何 文本 字符 ,一 般 用 HTML 书 写 ， 并且 可 以 使 用 UELI | 占 位 符 以 达到 动态 填充 的 目的 。 启 动 事件 中 的 activiti:formKey 属 性 就 是 用 


来 指定 使 用 哪个 表单 文件 (扩展 名 为 .form) 。 


动态 表单 : 此 类 型 表单 不 再 使 用 activiti:fotmKey 属 性 指定 表单 文件 ， 而 是 在 流程 定义 文件 中 设置 表单 中 元 素 集合 ， 包 含 各 种 输入 框 、 下 拉 框 等 。 对 应 的 XML 标示 如 下 : 


<activViti:formProperty id="name" name="Name" type="string"></activiti:formproperty> 


activiti:formProperty 可 以 有 多 个 ， 对 应 一 个 表单 中 的 多 个 字段 (Field) 。 在 实际 应 用 中 可 以 通过 引擎 提供 的 API 读 取 、 提 交 这 些 表单 元 素 。 


这 里 ， 对 于 不 同 表单 的 定义 方式 读者 有 一 个 概念 即 可 ， 在 “实战 篇 ”会 专门 讲解 详细 使 用 方法 及 其 适用 的 场景 。 


2. 定 时 启动 事件 


定时 启动 事件 可 以 用 于 一 次 性 定时 启动 、 特 定时 间 间 隔 后 启动 ， 在 BPMN 2.0 规 范 中 用 一 个 形象 的 钟表 图 形 表示 ， 如 图 4-3 所 示 。 


图 4-3 ”定时 启动 事件 


定时 启动 事件 常用 于 定期 循环 流程 或 一 次 性 流程 ， 例 如 公司 每 个 月 要 产生 一 次 业绩 报表 ， 可 以 设 定 每 个 月 1 号 系统 自动 生成 报表 并 自动 启动 公司 的 业务 处 理 流程 。 
对 应 的 ， 定 时 启动 事件 的 XML 描 述 和 图 形 方式 类 似 ， 在 基本 的 启动 事件 中 许 套 了 一 个 定时 事件 定义 timerEventDefinition， 对 应 的 XML 描 述 如 代码 清单 4-2 所 示 。 


代码 清单 4-2 ”定时 启动 事件 的 XML 描述 


<startEvent igd="timerStartEvent" name="Timer start event for report process"> 
<timerEventDefinition> #1 

<timeCycle>R1/2012-02-01T00:00/PMIM</timeCycle> #2 
</timerEventDefinition> 

</startEvent> 


代码 清单 4-2 中 #1 处 用 timerEventDefinition 描 述 一 个 定时 事件 ，#2 处 的 timerEvent-Definition 表 示 一 个 定时 事件 ，timeCycle 使 用 ISO 8601 四 标志 定义 了 一 个 循环 定时 器 ， 表 示 从 2012 年 2 月 1 日 起 每 
一 个 月 启动 一 次 流程 。 可 以 通过 多 种 方式 设置 定时 事件 ， 表 4-2 列 举 了 定时 启动 事件 的 三 种 定时 属性 。 


表 4-2 ”定时 启动 事件 的 定时 属性 


属性 名 称 属性 说 明 示 例 


一 次 性 定时 启动 ， 具 体 到 一 个 日 <timeDate>2012-12-12T00: 00: 00</timeDate> 
期 ， 用 ISO 8601 格式 设 定 在 这 个 指定 的 日 期 启动 一 次 流程 


timeDate 


<timeDuration>PT10M</ timeDuration > 
timeDuration 设置 多 长 时 间 之 后 局 动 流程 部 演 流 程 或 者 输出 流 的 上 一 个 任务 完成 10 分 钟 之 
后 局 动 流程 
周期 性 启动 任务 ， 用 来 设 定 循环 的 | <timeCycle>R3/PT10H</timeCycle> 循 环 3 次 ,每 
timeCycle 时 间 回 隅 ， 表 示 多 长 时 间 执 行 一 次 循 | 次 间隔 10 小 时 。 
环 。 同 样 还 是 用 ISO 8601 表示 在 timeDuration 的 基础 上 添加 了 循环 次 数 


3. 异 常 启动 事件 


异常 启动 事件 可 以 触发 一 个 异常 子 流程 ， 但 是 不 能 通过 APl (runtimeService.startProcess-lnstance() 方 法 ) 方式 启动 ， 它 总 是 在 另外 一 个 流程 抛 出 异常 结束 事件 (4.1.2 节 ) 的 时 候 被 触发 。 


异常 启动 事件 是 “捕获 型 ”， 而 异常 结束 事件 是 “ 抛 出 型 。， 和 Java 中 的 异常 处 理 机 制 类 似 。 异 常 结束 事件 对 应 throw， 而 异常 启动 事件 是 catch， 并 且 执 行 catch 后 获取 不 同类 型 的 异常 。 在 BPMN 
2.0 规 范 中 catch 需 要 两 者 的 错误 信息 匹配 才能 决定 是 否 触发 异常 启动 事件 。 


异常 启动 事件 的 图 形 化 表示 是 在 空 启动 事件 基础 上 嵌 套 了 一 个 雷电 符号 ， 如 图 4-4 所 示 。 


相对 于 空 启动 事件 来 说 异常 启动 事件 要 复杂 一 些 ， 必 须 嵌 套 在 一 个 事件 子 流程 (EventSubProcess， 参 见 4.5.3) 中 ， 如 图 4-5 中 的 虚线 部 分 所 示 ， 代 码 清单 4-3 展 示 了 一 个 简单 的 异常 启动 事件 的 应 用 。 


图 4-4 “异常 启动 事件 


JerVvIice [ask 


EITIIISSSSEEED EIEN 


Event sub Process 


User Task 


图 4-5 ”EventSubProcess 座 套 的 异常 启动 事件 


代码 清单 4-3 一 个 简单 的 异常 启动 事件 的 应 用 


<subProcess id="eventsubprocessl" name="Event sub Process" triggeredByEvent="true"> #1 
<startEvent id="errorstarteventl" name="Error start"> 
<errorEventDefinition errorRef="AIA001"></errorEventDefinition> #2 
</startEvent> 
<scriptTask id="scripttaskl" name="Script Task" scriptFormat="groovy"> #3 
<script><! [CDATA[out:println "catch an error";]]></script> 
</scriptTask> 


<sequenceFlow id="flow3" name="" sourceRef="errorstarteventl" targetRef= "scripttaskl"></sequenceFlow> 

<endEvent id="endevent3" name="End"></endEvent> 

<sequenceFlow id="flow4" name="" sourceRef="scripttaskl" targetRef="endevent3"> </sequenceFlow> 
</subProcess> 


代码 清单 4-3 中 #1 处 定义 了 一 个 事件 子 流程 ， 表 示 的 就 是 图 4-5 中 的 虚线 部 分 。 


#2 处 是 被 事件 子 流程 包 于 的 异常 事件 ， 并 且 指 定 异 常 代码 为 “AlIA001”， 异 常 代码 可 以 按照 项 目 命名 规范 进行 定义 ， 例 如 Oracle 的 错误 代码 规范 以 ORA 开 头 。 在 实际 应 用 中 根据 业务 类 型 和 错误 编号 
联合 表示 。 


#3 处 定义 了 一 个 scriptTask 用 来 输出 “catch an error” 文 字 ， 当 捕获 到 异常 代码 为 “AlIA001” 时 触发 异常 启动 事件 。 读 者 在 了 解 异常 启动 事件 时 要 结合 异常 结束 事件 来 理解 ， 两 者 的 关系 是 相互 依赖 
的 。 


4. 消 息 启动 事件 


消息 启动 事件 可 以 通过 一 个 消息 名 称 触 友 ， 从 而 启动 一 个 流程 实例 ; 还 可 以 结合 消息 抛 出 事件 一 起 使 用 ， 由 流程 自动 根据 消息 的 名 称 启动 对 应 的 流程 。 借 助 这 个 功能 在 实际 应 用 中 可 以 为 不 同 的 业务 处 
理 结果 启动 不 同 的 流程 。 


消息 启动 事件 的 图 形 化 表示 是 在 空 启动 事件 的 基础 上 嵌入 一 个 空心 的 信封 图 标 ， 如 图 4-6 所 示 ， 对 应 的 XML 描 述 如 代码 清单 4-4 所 示 。 


图 4-6 ”消息 启动 事件 


代码 清单 4-4 ”消息 启动 事件 的 XML 描 述 


<message id-="reSendFile" name=" 重 新 发 送 文件 "”/> 


<startEvent id="messageStart" > 
<messageEventDefinition messageRef="reSendFile " /> 
</startEvent> 


可 以 通过 Activiti 提 供 的 API 触 发 消息 启动 事件 ， 例 如 runtimeService.startProcess-InstanceByMessage (“ 重 新 发 送 文件 ”) 可 以 启动 一 个 包含 消息 名 称 为 “重新 发 送 文件 ”的 流程 ， 当 然 还 可 以 使 用 
像 在 第 2 章 的 Hello Word 例 子 中 启动 流程 的 runtimeservice.startProcesslnstanceByKey (…) 和 runtimeservice.startProcess-lnstanceByld (.…) 方法 那样 启动 一 个 以 消息 启动 事件 为 入 口 的 流程 ， 不 过 


这 些 方法 还 有 一 些 约束 ， 在 后 续 章节 将 会 一 一 通过 实例 方式 进行 比较 说明 。 


4.1.2 ”结束 事件 

有 始 有 终 ， 结 束 事件 和 启动 事件 通常 成 对 出 现在 流程 定义 中 ， 当 然 在 定义 流程 时 也 允许 没有 结束 事件 (但 是 开始 事件 不 可 缺少 ) 。 结 束 事件 在 BPMN 2.0 规 范 中 用 一 个 圆 形 表示 ， 和 启动 事件 类 似 但 有 
一 点 不 同 是 线条 加 粗 了 ， 如 图 4-7 所 示 。 结 束 事件 可 以 细 分 为 以 下 几 种 类 型 : 

. 空 结束 事件 

. 异常 结束 事件 

. 取消 结束 事件 


结束 事件 表示 流程 (包含 子 流程 ) 的 结束 ， 和 启动 事件 的 触发 型 不 同 的 是 结束 事件 总 是 抛 出 型 的 ， 也 就 是 当 流 程 执行 到 结束 事件 时 会 抛 出 一 个 执行 结果 。 


图 4-7 ”结束 事件 的 基本 图 形 


所 有 的 开始 事件 均 以 如 图 4-7 所 示 的 粗 线条 圆 形 为 基础 ， 本 节 讲 解 的 其 他 事件 都 是 在 其 基础 上 “ 许 入 ”对 应 类 型 的 图 形 来 表示 一 种 结束 事件 。 
1. 空 结束 事件 


结束 事件 是 抛 出 型 的 ， 空 结束 事件 不 处 理 抛 出 结果 ， 也 可 以 理解 为 抛 出 的 是 一 个 “ 空 


”， 所 以 没有 什么 需要 流程 引擎 处 理 的 。 对 于 空 结束 事件 ， 正 常 结束 后 流程 引擎 就 不 会 再 执行 其 他 的 操作 了 ， 因 为 
一 切 都 已 结束 了 ， 而 且 没 有 后 续 处 理 (结束 事件 不 能 再 有 输出 流 ) 。 空 结束 事件 的 图 形 表示 如 图 4-7 所 示 。 
空 结束 事件 和 空 启动 事件 的 XML 描 述 一 样 简单 ， 如 代码 清单 4-5 所 示 。 
代码 清单 4-5” 空 结束 事件 的 XML 描 述 


<enad] 


Event id="end" name="my end event"/> 


空 结束 事件 一 般 用 于 正常 结束 流程 ， 也 就 是 说 流程 的 执行 过 程 一 切 都 符合 预 设 的 业务 逻辑 ， 如 果 需 要 处 理 异常 就 需要 使 用 异常 结束 事件 或 边界 事件 处 理 (4.6.1 节 ) 。 


2. 异 常 结束 事件 


异常 结束 事件 相对 于 空 结束 事 件 来 说 就 好 理解 一 些 了 ， 空 结束 事件 的 抛 出 结果 是 “ 空 ”， 而 异常 结束 事件 是 有 抛 出 结果 的 。 它 定义 了 需要 抛 出 的 错 
则 会 触发 异常 开始 事件 ， 否 则 按照 空 结束 事件 规则 处 理 。 有 一 点 需要 注意 ， 异 常 结束 事件 的 错误 代码 不 能 为 空 。 


异常 结束 事件 的 图 形 表 示 是 在 空 结束 事件 的 基础 上 添加 了 一 个 雷电 符号 ， 如 图 4-8 所 示 。 


号 


误 代码 ， 如 果 找 到 了 异 弟 开始 事件 定义 的 异 剃 代码 ， 


图 4-8 “异常 结束 事件 


异常 结束 事件 的 XML 描 述 是 在 空 结束 事件 中 嵌 套 了 一 个 异常 事件 errorEventDefinition， 如 代码 清单 4-6 所 示 。 


代码 清单 4-6 “异常 结束 事件 的 XML 描述 


<endEvent id="endeventl1l" name="ErrorEnd"> #1 
<errorEventDefinition errorRef="AIA-001"></errorEventDefinition> #2 
</endEvent> 


代码 清单 4-6 中 的 #1 处 定义 了 一 个 普通 的 结束 事件 。 


#2 处 定义 了 一 个 errorEventDefinition 表 示 一 个 异常 事件 ， 当 遇 到 异常 结束 事件 时 ， 引 警 查询 定义 为 errorRef 属 性 值 的 异常 启动 事件 并 触及。errorRef 属 性 用 来 描述 错误 编号 ， 可 以 按照 项 目 命名 规范 进 
行 定义 ,例如 Oracle 的 错误 代码 规范 以 ORA 开 头 。 在 实际 应 用 中 根据 业务 类 型 和 错误 编号 联合 表示 。 


忆 注 意 不 要 把 这 里 的 异常 和 ]Java 的 异常 混为一谈 ，BPMN 2.0 中 的 异常 仅仅 描述 异常 定义 及 处 理 方式 。 
3. 终 止 结束 事件 


终止 结束 事件 是 结束 事件 中 的 一 个 比较 特别 的 类 别 ， 它 可 以 终止 一 个 流程 实例 的 执行 ， 例 如 在 付费 流程 中 因为 某 些 原因 导致 流程 不 能 继续 运行 ， 最 终 的 结果 是 取消 本 次 付费 ， 所 以 需要 提前 结束 流程 实 
例 的 执行 ， 此 时 可 以 把 某 个 输出 流 指向 到 终止 结束 事件 。 空 启动 事件 结束 的 仪 仪 是 一 条 输出 流 ， 而 终止 结束 事件 结束 的 是 整个 流程 实例 。 


终止 结束 事件 的 图 形 表示 是 在 空 结束 事件 的 基础 上 添加 了 一 个 实心 的 圆 点 ， 如 图 4-9 所 示 。 


图 4-9 ”异常 结束 事件 


终止 结束 事件 的 XML 描述 是 在 空 结束 事件 中 岁 套 了 一 个 终止 事件 terminateEventDefinition， 如 代码 清单 4- 7 所 示 。 


代码 清单 4-7 终止 结束 事件 的 XML 描 述 


<endEvent id="terminateendeventl" name="TerminateEndEvent"> 
<terminateEventDefinition></terminateEventDefinition> 
</endEvent> 


4. 取 消 结 束 事件 
取消 结束 事件 可 以 取消 一 个 事务 子 流程 (4.5.4 节 ) 的 执行 ， 同 时 也 只 能 在 子 流程 中 使 用 。 当 子 流程 执行 过 程 中 出 现 异常 需要 取消 时 ， 可 以 设置 一 个 取消 结束 事件 ， 当 输出 流 指 向 到 取消 结束 事件 时 流程 


将 会 中 断 执行 。 取 消 结束 事件 还 可 以 和 取消 边界 事件 (4.6.1 节 ) 配合 使 用 针对 取消 操作 做 后 续 处 理 。 


取消 结束 事件 的 图 形 表示 是 在 空 结束 事件 基础 上 嵌入 一 个 “X” 图形， 如 图 4-10 所 示 ， 对 应 的 XML 描述 如 代码 清单 4-8 所 示 。 


图 4-10 ”取消 结束 事件 


代码 清单 4-8 ”取消 结束 事件 的 XML 描述 


<endEvent id="myCancelEndEvent"> 
<cancelEventDefinition /> 1 
</endEvent> 


代码 清单 4-8 的 #1 处 定义 了 cancelEventDefinition 标 签 来 声明 这 是 一 个 取消 事件 ， 读 者 可 结合 事务 子 流程 (4.5.4 节 ) 中 的 取消 结束 事件 来 理解 。 


[1] 关于 UEL 读 者 可 以 参考 JAVAEE6 中 的 定义 : http://docs.oracle.com/javaee/6/tutorial/doc/gjddd.html。 


[2] http://en.wikipedia.org/wiki\ISO_8601 


4.2 顺序 流 


顺序 流 是 两 个 模型 之 间 的 连接 者 ， 可 以 把 顺序 流 比 作 人 体 的 动脉 每 一 条 连接 到 不 同 的 器 官 ， 在 BPMN 2.0 规 范 中 每 个 输出 流连 接 到 不 同 的 活动 、 事 件 。 如 果 一 个 元 素 在 流程 执行 期 间 被 访问 ， 流 程 会 


沿 着 该 元 素 所 有 输出 顺序 流 继续 执行 。 这 意味 着 BPMN 2.0 默 认 行 为 是 并 行 的 : 多 个 输出 顺序 流 会 创建 多 条 独立 、 并 行 的 执行 路 径 。 
顺序 流 可 以 细 分 为 两 种 : 
. 标准 顺序 流 
. 条 件 顺 序 流 


4.2.1 ”标准 顺序 流 


标准 顺序 流 可 以 用 来 连接 两 个 或 多 个 模型 建立 关系 ， 在 BPM N2.0 规 范 中 如 图 4-11 所 示 ， 对 应 的 XML 描述 如 代码 清单 4-9 所 示 。 


图 4-11 异常 结束 时 间 


代码 清单 4-9 ”标准 顺序 流 的 XML 摘 述 


<sequenceFlow id="flow" sourceRef="startEvent" targetRef="userTask"></sequenceFlow> 


从 代码 清单 4-8 中 可 以 看 出 ， 用 sequenceFlow 表 示 一 个 顺序 流 ， 用 sourceRef 属 性 指定 顺序 流 的 源 ， 用 targetRef 属 性 指定 顺序 流 的 目的 模型 。 


Activiti 还 对 顺序 流 进行 了 扩展 ， 人 允许 开发 人 员 在 顺序 流 上 添加 监听 器 (参考 4.7.1 节 ) 。 


4.2.2 条件 顺 序 流 


条 件 顺序 流 是 在 标准 顺序 流 上 添加 了 条 件 表达 式 ， 只 有 满足 条 件 才 能 通过 顺序 流 到 达 目 标 活动 。BPM N 2.0 规 范 定 义 的 条 件 顺 序 流 图 形 如 图 4-12 所 示 。 


图 4-12 ” BPMN 2.0 规 范 的 条 件 顺 序 流 图 形 


加 说 明 在 Activiti Designet 中 设置 条 件 顺 序 流 没 有 图 4-12 所 示 的 图 形 ， 取 而 代 之 的 是 标准 顺序 流 ， 在 设计 的 时 候 不 设置 condition 的 就 是 标准 顺序 流 ， 设 置 了 condition 的 就 变 成 了 条 件 顺 序 流 。 
条 件 顺 序 流 的 XML 描 述 是 在 顺序 流 中 添加 了 条 件 表达 式 标签 conditionExpression， 并 且 在 conditionExpression 中 设置 UELI1J 表 达 式 用 于 计算 逻辑 值 ， 如 代码 清单 4-10 所 示 。 


代码 清单 4-10 条件 顺 序 流 的 XML 描 述 


<sequenceFlow id="flow5" name="" sourceRef="startevent2" targetRef="usertaskl"> 
<conditionExpression xsi:type="tFormalExpression"> #1 
<! [CDATA[${pass == true}]]> #2 
</conditionExpression> 
</sequenceFlow> 


代码 清单 4-9 中 的 #1 处 使 用 conditionExpression 标 签 定 义 了 一 个 条 件 表 达 式 ， 并 且 使 用 xsi:type 指 定 表 达 式 的 类 型 为 tformalExpression， 目 前 条 件 表达 式 仪 支持 UEL。#2 处 的 条 件 使 用 CDATA 方 式 摘 
述 ， 在 运行 时 交 由 引擎 根据 变量 pass 的 值 和 true 进 行 比较 ， 还 可 以 简化 为 <! [CDATA[${pass}]]>。 


[1] http://uel.java.net/ 


4.3 任务 


任务 是 一 个 流程 中 最 重要 的 组 成 部 分 ， 根 据 业 务 需求 的 不 同 也 分 为 很 多 种 类 型 : 
* 用 户 任务 

` 脚本 任务 

:WebService 任务 

. 业务 规则 任务 

` 邮件 任务 

. Mule 任 务 

.Camel 任 务 

. 手动 任务 

. Java setvice 任 务 


.Shell 任务 


所 有 的 任务 的 图 形 化 表示 都 是 以 一 个 和 矩形 为 基础 ， 在 左上 角 添 加 具体 类 型 的 图 标 。 大 多 数 任务 都 有 单独 的 XML 定义 ， 用 来 描述 一 种 特定 任务 类 型 ， 也 有 部 分 任务 是 基于 serviceTask 扩 展 的 。 


4.3.1 ”用户 任务 


顾名思义 ， 用 户 任务 需要 人 来 参与 ， 因 为 它 必须 被 人 为 触 友 (完成 任务 动作 ) 。 用 户 任务 可 以 定义 任务 的 名 称 (例如 “领导 审批 ”) 、 优 先 级 、 到 期 日 和 任务 处 理 人 (可 以 是 人 、 组 或 者 两 者 的 组 
合 ) 。 图 4-13 展 示 了 用 户 任务 的 图 形 。 


图 4-13 用 户 任务 


用 户 任务 使 用 userTask 表 示 ， 代 码 清单 4-11 中 定义 了 一 个 基本 的 用 户 任务 ， 把 任务 分 配给 ID 为 henryyan 的 用 户 办 理 。 


代码 清单 4-11 ”用户 任务 的 XML 摘 述 一 一 分 配 任务 给 henryyan 


<userTask id="leaderAudit" name=" 领 导 审 批 "> #1 
<humanPerformer> #2 

<resourceAssignmentExpression> 

<formalExpression>henryyan</formalExpression> #3 


</resourceAssignmentExpression> 
</humanPerformer> 
</userTask> 


代码 4-11 中 #1 处 定义 了 一 个 名 称 为 “领导 审批 ”用 户 任 务 ，#2 处 用 humanPerformer 标 签 定 义 表示 把 这 个 任务 分 配给 一 个 人 ， 并 且 在 #3 处 用 一 个 表达 式 指 定 了 用 户 任务 分 配给 用 户 henryhan 办 理 。 
用 户 任务 除了 可 以 分 配给 一 个 用 户 之 外 还 可 以 分 配给 组 或 两 者 混合 ， 代 码 清单 4-12 展 示 了 把 一 个 任务 同时 分 配给 多 个 候选 人 。 


代码 清单 4-12 ”用 户 任务 的 XML 描述 一 一 分 配 任务 给 多 个 候选 人 


<userTask igd="leaderAudit" name=" 领 导 审批 "> 
<potentialOwner> #1 
<resourceAssignmentExpression> 
<formalExpression> 
user (henryyan) ,group (leader), manager #2 
</formalExpression> 


</resourceAssignmentExpression> 
</potentialOwner> 
</userTask> 


代码 清单 4-11 中 的 #1 处 用 potentialOwnet 标 签 来 描述 一 个 潜在 的 用 户 、 组 集合 ，#2 处 把 “领导 审批 ”这 个 用 户 任务 同时 分 配给 用 户 henryyan、 组 leader 和 和 组 manager。 现 在 读者 要 问 为 什么 
group(leave) 和 manager 都 是 分 配 到 组 呢 ? 这 是 因为 如 果 不 添加 user 或 group 关 键 字 说 明 括 号 中 的 候选 人 属于 什么 类 型 ， 那 么 BPMN 2.0 规 泥 默 认为 组 (group) 。 


此 外 Activiti 在 BPMN 2.0 的 基础 上 进行 扩展 ， 可 以 简化 设置 用 户 、 组 的 方式 ， 而 且 支 持 动态 (运行 时 ) 获取 用 户 、 组 分 配给 用 户 任务 ; 还 可 以 为 用 户 任务 设置 创建 、 分 配 、 完 成 监听 。 表 4-3 列 举 了 
Activiti 扩 展 的 用 户 任务 属性 。 


表 4-3 Activiti 扩 展 的 用 户 任务 属性 


属性 名 称 属性 说 明 示 例 


cl yw <userTask 1d="leader Audit" 
用 来 指定 用 户 任 务 的 处 理 人 ,， 


i name=" 领导 审批 " 
humanPerformer 的 功能 ， 
activiti:assignee="henryyan"/> 


activiti:assignee 


nh /> 


<userTask 1d="leaderAudit" 
name=" 领导 审批 " 


activiti:cadidateUsers="henryyan" 


用 来 指定 用 户 任务 的 候选 人 ， 多 个 用 
逗号 分 开 ， 代 和 蔡 了 了 potentialOwner 的 功能 


activiti:cadidateUsers 


<userTask 1d="leaderAudit" 
name=" 领导 审批 " 


activiti:cadidateGroups="leader. 


用 来 指定 候选 组 ， 多 个 用 运 


activiti:cadidateGroups es “Es 
符 了 了 potentialOwner 的 功能 


manager" 
/> 


<userTask 1d="leaderAudit" 
name=" 领导 审批 " 
activiti:dueDate="$ {overDate}" 


- | 其 日 | 各 用 变 量 代 
activiti:dueDate 过 | 有 间 个 是 非 定 _- ~ 有 具体 的 日 期， 因 te 


<userTask 1d="leaderAudit" 
name=" 领导 审批 " 


activiti:priority 用 户 任 务 的 优先 级 ， 取 值 区间 [0, 100] 六 
actlvltl:DITIOTIty=" 9 {priority} 


代码 清单 4-13 展 示 了 通过 Activiti 的 扩展 属性 设置 用 户 任务 的 办 理 人 ， 以 代替 BPM AN 2.0 规 学 中 繁琐 的 配置 。 


代码 清单 4-13 ”使 用 Activiti 扩 展 属 性 设置 用 户 任务 的 办 理 人 和 候选 人 


<userTask id=" leaderAudit " name=" 领 导 审 批 " 
activiti:candidateUsers=" henryyan" 
activiti:candidateGroups="groupl, group2"> 
</userTask> 


除了 表 4-3 中 的 属性 之 外 ，Activiti 还 允许 在 用 户 任务 上 添加 任务 监听 ， 监 听 的 选项 有 : create (创建 任务 ) 、assignment (分 配 任 务 ) 、complete (完成 任务 ) ， 如 代码 清单 4-14 所 示 。 


代码 清单 4-14 ”使 用 Activiti 扩 展 标 签 设置 用 户 任务 的 办 理 人 和 候选 人 


<userTask id="leaderAudit"” name=" 领 导 审 批 "> 
<extensionElements> 
<activiti:taskListener class="me.kafeitu.activiti.LeaderTaskListener" event="complete" /> 
</extensionElements> 
</userTask> 


代码 清单 4-13 中 的 配置 可 以 在 “领导 审批 ”用 户 任务 完成 的 时 候 触发 Leader-TaskListener 监 听 。 除 了 可 以 通过 class 属 性 指定 一 个 java 的 class 文 件 (jar 包 中 的 全 路 径 ) 之 外 ， 还 可 以 定义 expression 和 
delegateExpression 以 表达 式 方 式 处 理 监 听 。 


关于 监听 器 的 设置 在 4.7 节 中 会 详细 讲解 。 


4.3.2 ”脚本 任务 


脚本 任务 可 以 运行 引擎 依赖 的 语言 之 外 的 脚本 语言 ， 例 如 Activiti 支 持 的 Groovy、Javascript、Juel。 在 BPMN 2.0 规 范 中 脚本 任务 的 图 形 表示 如 图 4-14 所 示 。 


图 4-14 ”脚本 任务 
值得 注意 的 是 ， 脚 本 任务 的 代码 需要 符合 JSR-223l1] (Java 平 台 脚本 ，scripting for the java plateform) 规范 。 
代码 清单 4-15 中 定义 了 个 Groovy 类 型 的 脚本 任务 。 


代码 清单 4-15 ”使 用 Groovy 作 为 脚本 引擎 的 脚本 任务 


<scriptTask idq="initvars" name=" 初 始 化 变量 " 析 
scriptFormat="groovy"> #2 
<script><! [CDATAT[ #3-S 
def name = "HenryYan™; 
execution.setVariable('name', name); 
1]]> 
</script> #3-E 
</scriptTask> 
<scriptTask igd="printvars" name=" 输 出 变量 " #4 
scriptFormat="groovy"> 
<script><! [CDATA[out:println name;]]></script> #6 
</scriptTask> 


代码 清单 4-15 中 定义 了 两 个 Groovy 脚 本 任务 ， 其 中 #1、#4 处 分 别 使 用 scriptTask 定 义 了 两 个 脚本 任务 ，#2、#5 处 通过 scriptFormat 指 定 脚本 任务 为 Groovy 类 型 ，#3、#6 处 是 用 来 设置 脚本 任务 执行 的 代 
码 。 第 一 个 脚本 任务 用 来 设置 变量 name 的 值 为 HenryYan， 第 二 个 脚本 任务 用 来 输出 变量 name。 


Activiti 除 了 默认 支持 的 三 种 脚本 语言 Groovy、JavaScript、Juel， 还 允许 使 用 其 他 的 脚本 语言 ， 前 提 是 把 依赖 的 jar 包 设置 到 classpath 中 。 表 4-4 列 举 了 脚本 任务 的 属性 。 


表 4-4 脚本 任务 的 属性 


属性 名 称 属性 说 明 示 例 


用 来 指定 符合 JSR-223 规范 的 脚 | “scrptiasc 6 serpttask 
本 语言 的 类 型 name=" 初始 化 变量 " 
A 日 HJ 大 过 


scriptFormat="groovy"/> 


scriptFormat 


Activiti 在 原 BPMN 2.0 规 范 中 <scriptTask id="scripttask1" name=" 初始 化 变量 " 
的 脚本 任务 基础 上 进行 了 扩展 ， 可 | scriptFormat="juel" activiti:resultVariable="name"/> 
以 把 脚本 处 理 的 结果 保存 到 一 个 变 注意 activiti:resultVariable 指定 的 变量 名 称 需 要 
量 中 在 脚本 中 预先 定义 才能 使 用 


activiti:resultvariable 


4.3.3 Java Service 任 务 


首先 声明 Java Service 不 属于 BPMN 2.0 规 范 ， 而 是 Activiit 扩 展 的 专门 应 用 于 Java 语 言 的 serviceTask。 其 图 形 表 示 如 图 4-15 所 示 。 


ava ServIce 


图 4-15 ”Java Service 任 务 
Java Service 任 务 允 许 定义 一 个 实现 了 指定 接口 的 Java 类 ,或 者 执行 一 个 表达 式 ; 还 可 以 像 脚本 任务 一 样 把 结果 保存 到 一 个 变量 中 。 
Java Service 任 务 对 应 的 XML 如 代码 清单 4-16 所 示 。 


代码 清单 4-16 _ Java Service 任 务 对 应 的 XML 描述 


<serviceTask id="myServiceTask" name="Learn Java Service Task" #1 
activiti:class="me.kafeitu.activiti.JavaServiceDelegate" > #2 
</serviceTask> 


代码 清单 4-16 中 的 #1 处 使 用 serviceTask 标 签 定义 一 个 Java Service 任 务 ，#2 处 设置 activiti:class= “me.kafeitu.activiti.JavaServiceDelegate” 表 示 这 个 任务 需要 执行 一 个 Java 类 ， 这 个 Java 类 需要 遵 


循 Activiit 的 Java Service 规 范 实现 JavaDelegate、ActivityBehavior 中 的 一 个 接口 。 
在 指定 一 个 Java 类 的 同时 还 可 以 配置 执行 Service 时 传 入 的 变量 ， 这 样 在 执行 Java 类 的 时 候 可 以 读 取 预 先 设置 的 变量 值 。 
除了 使 用 activiti:class 指 定 一 个 Java 类 之 外 ， 还 可 以 使 用 其 他 的 几 种 方式 定义 Java Service 任 务 需 要 执行 的 Java 对 象 ， 表 4-5 列 举 了 Activiti 扩 展 的 Java Service 任 务 的 属性 。 


表 4-5 Activiti 扩 展 的 Java Service 任 务 的 属性 


属性 名 称 属性 说 明 示 例 


1 re 和 a <serviceTask 1d="serviceTask]1" 
实现 了 接口 JavaDelegate 或 Activity- 


. a activiti:class=" 
Behavior 的 Java 类 


activiti:class 
1 


me.kafeitu.activiti.JavaServiceDelegate "/> 
rn ER Re ne ed | iceTask 1d=" rice Task1" 
可 以 使 用 UEL 定义 需要 执行 的 任 serviceTask 1 serviceTas 
务 内 容 ， 例 如 计算 公式 、 调 用 Bean 
SE 对 和 象 的 方法 ; 并 且 在 执行 任务 的 时 候 
和 可 以 使 用 流程 变量 作为 参数 。Bean 


实例 除了 可 以 使 用 new 创建 之 外 ， 


activiti:expression= 

"#{leaveService.back()}"/> 
其 中 leaveService 作为 一 个 流程 变量 存在 ， 和 
activiti:class 一 样 需要 实现 JavaDelegate 接口 
或 ActivityBehavior 接口 ， 另 外 还 实现 了 java. 
io.Serializable 接口 以 便 引 擎 可 以 序列 化 变量 


还 可 以 使 用 Spring 代理 


功 能 和 activiti:class 类 似 ， 而 

旦 同样 需要 实现 JavaDelegate 或 人 
activiti:expression= 

ActivityBehavior 中 一 个 接口 ， 只 "$1 F BackDelegate}"/> 

ee ee a eaveBackDelegate}", 

activiti:delegateExpression | 不 过 这 里 不 是 指定 一 个 具体 的 实现 | ,.,, , we 

和 执行 到 此 任务 时 引擎 会 从 变量 中 查询 名 称 为 
类 ， 而 是 在 运行 时 动态 设置 。 和 z i 

es i .| leaveBackDelegate 的 Bean 对 象 ， 然 后 调用 实 
activiti:expression 类 似 ，Bean 可 以 现 接口 的 方法 
使 用 new 创建 也 可 以 用 spring 代理 | 


< serviceTask 1d=" ServlceTask1"” 


属性 名 称 属性 说 明 示 例 


此 属性 仅 适 用 于 activiti:expression | <serviceTask id= " serviceTask1" activiti: 
类 型 的 Java Service， 可 以 把 一 个 |expression="#{leaveService.back()}"activiti: 
表达 式 的 执行 结果 保存 到 activiti: | resultVariable="backDate"/> 把 leaveService. 
resultVariable 指定 的 变量 名 称 中 back() 执行 的 结果 保存 到 变量 backDate 中 


activiti:resultVariable 


4.3.4 Web Service 任 务 


通过 Web service 任务 可 以 调用 外 部 的 Web Service 资 源 ， 完 成 调用 只 需要 一 些 必须 的 配置 就 可 以 ， 并 且 支 持 标准 的 Web service 和 REST 风 格 的 Service。Web service 任务 的 图 形 表示 如 图 4-16 所 示 。 


图 4-16 ”Web Service 任 务 


Web service 任 务 对 应 的 XML 描述 如 代码 清单 4-17 所 示 。 


代码 清单 4-17 Web Service 任 务 的 XML 描述 


<serviceTask id="webServiceTask" implementation="##WebService"> #1 
<ioSpecification> #2 
<qataInput itemSubjectRef="tns:prettyPrintCountRequestItem" 
id="dataInputOfServiceTask"/> 
<qataoutput itemSubjectRef="tns:prettyPrintCountResponseIltem" 
id="dataOutputOfServiceTask"/> 
<inputSet> 
<dataInputRefs>dataInputOfServiceTask</dataInputRefs> 
</inputSet> 
<outputSet> 
<dataOutputRefs> 
dataOutputOfServiceTask 
</dataOutputRefs> 
</outputSet> 
</ioSpecification> 
<dataInputAssociation> 
<sourceRef>PrefixVariable</sourceRef> 
<targetRef>prefix</targetRef> 
</dataInputAssociation> 
<dataInputAssociation> 
<sourceRef>SuffixVariable</sourceRef> 
<targetRef>suffix</targetRef> 
</dataInputAssociation> 
<dataOutputAssociation> 
<sourceRef>prettyPrint</sourceRef> 
<targetRef>OutputVariable</targetRef> 
</dataOutputAssociation> 
</serviceTask> 


在 代码 清单 4-17 中 ，#1 处 使 用 implementation= “##Webservice” 属 性 设置 Task 为 Web Service 类 型 ，#2 处 通过 ioSpecification 元 素 定义 输入 、 输 出 参数 : 在 元 素 datalnputAssociation 中 定义 了 数 
据 输入 关系 ; 在 元 素 dataOutputAssociation 中 定义 了 数据 输出 关系 。 


4.3.5 ”业务 规则 任务 


在 企业 应 用 中 一 般 都 会 使 用 可 维护 的 规则 库 来 管理 复杂 多 变 的 业务 规则 ， 可 以 把 业务 逻辑 和 规则 分 开 维护 ， 一 旦 规则 有 变动 ， 只 需要 更 改 预 设 规则 即 可 。 业 务 规则 任务 可 以 根据 流程 变量 的 值 处 理 预 设 
的 业务 规则 。 


Activiti 对 业务 规则 提供 了 很 好 的 支持 ， 目 前 支持 比较 流行 的 JBoss 规则 引擎 一 一 Drools 和 内。 只 需 把 含有 业务 规则 任务 的 流程 文件 和 规则 引 警 文件 “.drl ”一同 打 包 部 署 到 系统 中 ， 同 时 把 Drools 的 jar 包 添 


加 到 classpath 即 可 实现 Activiti 驱 动 规则 引擎。 业务 规则 任务 的 图 形 表 示 如 图 4-17 所 示 。 


SuSsiness rule tas 


图 4-17 业务 规则 任务 


业务 规则 任务 的 XML 描 述 如 代码 清单 4-18 所 示 。 


代码 清单 4-18 业务 规则 业务 规则 任务 的 XML 摘 述 


<businessRuleTask id="businessruletaskl" name="Business rule task" 
activiti:rules="rulel, rule?2™" activiti:ruleVariablesInput="$ {message}" 
activiti:exclude="false" activiti:resultVariableName="rulesOutput"> 


</businessRuleTask> 


在 介绍 Activiti 的 扩展 属性 之 前 ， 读 者 需要 先 明白 规则 引擎 的 作用 ， 简 单 来 说 就 是 把 业务 数据 交 由 规则 引擎 处 理 ， 规 则 引擎 根据 不 同业 务 规则 (各 种 条 件 的 判断 ) 计算 得 出 最 终结 果 ， 最 后 把 结果 返回 给 


调用 者 ， 在 BPMN 2.0 中 的 调用 者 为 流程 引擎 (在 本 书 中 为 Activiti) 。 
Activiti 在 原 有 的 业务 规则 规范 上 扩展 了 一 些 属性 以 便 与 Drools 整 合 ， 表 4-6 列 举 了 Activiti 扩 展 的 业务 规则 任务 的 属性 。 


表 4-6 Activiti 扩 展 的 业务 规则 任务 的 属性 


属性 名 称 属性 说 明 示 例 


在 规则 文件 .drl 中 定义 的 规则 名 称 ，| <businessRuleTask 
activiti:rules 多 个 规则 用 逗号 分 隔 。 要 执行 规则 文件 | id="businessruletaskl" 
中 的 全 部 规则 ， 将 该 属性 设置 为 空 即 可 | activiti:rules="rulel, rule2" /> 


AAA 
凑 
ae 


属性 名 称 属性 说 明 示 例 


业务 规则 执行 需要 的 数据 源 ，ff <businessRuleTask 


ne a 1d="businessruletask1" 
activiti:ruleVariablesInput $ {fooVar} 方式 定义 ， 多 个 规则 用 去 NE ， 
分 隔 activiti:ruleVariablesInput="S {message!} 
丰采 了 


<businessRuleTask 
规则 执行 结果 变量 ， 的 但 - 1d="businessruletask1" 


i™ 


activiti:resultVariableName ruleVariablesInput activiti: resultVariableName =" 


(ArrayList) rulesOutputVaraibleList" 
/> 


用 来 设置 是 否 排除 茶 些 规则 
(rule)， 如 果 值 为 false， 不 排除 按照 
activiti:rules 规则 执行 ;如 果 设 置 为 
true， 则 忽略 activiti:rules 指定 的 规则 。 
如 果 设 置 为 false 的 同时 activiti:rules 
值 为 空 ， 则 不 执行 任何 规则 


<businessRuleTask 
1d=="businessruletask1" 
activiti:execlude activiti:rules="rule2"activiti: execlude ="true" 
/> 


此 例 中 忽略 规则 rule2， 仅 执行 规则 rule] 


4.3.6 ”邮件 任务 


邮件 任务 可 以 通过 Activiti 发 送 邮 件 ， 其 中 的 邮件 信息 通过 变量 方式 传递 。 邮 件 任 务 不 属于 BPMN 2.0 规 范 而 是 和 Java Service 任 务 类 似 ， 由 Activiti 扩 展 而 来 专门 用 于 处 理 邮 件 任 务 ， 其 图 形 表示 如 图 4- 
18 所 示 。 


图 4-18 ”邮件 任务 


邮件 任务 是 在 serviceTask 的 基础 上 由 Activiti 添 加 了 扩展 属性 activiti:type= “mail” 实 现 的 。 邮 件 任 务 的 XML 描 述 如 代码 清单 4-19 所 示 。 


代码 清单 4-19 ”邮件 任务 的 XML 描述 


<serviceTask id="mailtaskl" name="Mail Task" activiti:type="mail"> 

<extensionElements> 
<activiti:field name="to" expression="henryyan@gmail.com"></activiti:field> 
<activiti:field name="from" expression="yanhonglei@gmail.com"></activiti:field> 
<activiti:field name="subject" expression="hello henryyan"></activiti:field> 
<activiti:field name="charset" expression="UTF-8"></activiti:field> 
<activiti:field name="html"> 

<activiti:expression><! [CDATA[ 你 好 ， 我 是 ${userName}。]]></activiti:expression> 

</activiti:field> 

</extensionElements> 


</serviceTask> 


发 送 邮 件 需要 配置 邮件 服务 器 信息 到 流程 引 警 中， 可 以 在 activiti.cfg.xml 定 义 的 引擎 属性 中 设置 。 表 4-7 列 举 了 配置 邮件 服务 器 的 属性 。 


表 4-7 配置 邮件 服务 器 的 属性 


属性 名 称 是 否 必须 描 述 


邮件 服务 带 的 主机 名 (例如 smtp. 


mailServerHost . ee 
gmail.com )， 默 认为 localhost 


SMTP 通信 痊 口 ， 默 认为 25 ; 如 果 使 
用 SSL， 则 为 465 


是 ， 如 果 不 是 默认 的 端口 


mailServerPort 


l 发 件 人 email， 如 果 不 设 置 ， 上 默认 为 
mailServerDefaultFrom pe 
acitiviti(Vactiviti.org 

mailServerUsername 否 ， 根 据 服 务 带 是 否 需要 认证 设置 邮件 服务 认证 账号 ， 默 认为 空 


mailServerPassword 否 ， 根 据 服 务 堪 是 否 需 要 认证 设置 邮件 服务 认证 密码 ， 默 认为 空 


代码 清单 4-19 中 的 邮件 任务 配置 统一 使 用 activiti:field 元 素来 配置 ，name 不 同 表示 不 同 的 参数 ， 均 支持 变量 方式 指定 值 。 表 4-8 列 举 了 邮件 任务 的 属性 。 


表 4-8 邮件 任务 的 属性 说 明 


<activiti:field 
必 填 。 收 件 人 ， 多 个 收 件 人 由 逗号 name= to 
分 隔 的 列表 来 定义 expression="$ {to}" 


Fs 


1 一 


to 


邮件 发 送 人 人 地址。 如 果 不 设置 ， 使 eh 


from 用 引擎 的 mailSserverDefaultFrom 属性 
指定 的 发 件 人 


name="from" 
二 WE 一 利生 下 出 
expression="$ {from,} 


I 
jf 


<Aactiviti:field 


a 发 件 人 email， 如果 不 设置 ， 默 认 name="subject" 
subjec ee . < 
为 acitiviti(@activiti.org expression="$ {subject}" 
/> 
<activiti:field 
Dame 一 cc- 
CC . 
expression="$ {cc}" 
/> 
<activiti:field 
name="cece" 
bee . | 
expression="$ {cc}" 
/> 
<activiti:field 
rp je, Ha je 本 两 ” ， = i 2 加 
| 1 邮件 内 容 宇 符 集 ， 建 议 使 用 UTF-8 name="charset" 
charse 


防止 中 文 乱码 expression="$ {charset}" 


属性 名 称 属性 说 明 示 例 


<activiti:field 

, 多 Re name="text" 

text 纯 文本 格式 的 邮件 内 容 
expression="$ {email! 

> 


<activiti:field name="html"> 
<activiti:expression> 
<![CDATAI[ 
<html> 
<body> 
你 好 ， 我 是 <b>$ {userName}</b>。 
</body> 
</html> ]]> 
</activiti:expression> 
</activiti:field> 


html html 格式 的 邮件 内 容 


4.3.7 “Camel 任 务 
CamelB] 是 由 Apache 开 源 组 织 开发 的 基于 Apache 2 协议 的 企业 系统 整合 框架 ， 是 EIP (Enterprise Integration Patterns， 企 业 集成 模式 ) 的 实现 ， 是 用 来 解决 消息 路 由 的 框架 。 类 似 的 产品 还 有 
Mule、Spring Intergretion 等 。 


Camel 任 务 是 使 用 Java 语 言 编写 的 ， 所 以 不 包含 在 BPMN 2.0 规 范 中 ， 而 是 由 Activiti 在 serviceTask 的 基础 上 扩展 的 一 个 任务 模型 。Activiti 对 其 提供 了 很 好 的 集成 支持 。 可 以 通过 
activitidelegateExpression 属 性 指定 Camel 的 上 下 文 ， 在 运行 时 由 引 警 调用 Camel 路 由 处 理 任务 。Camel 任 务 的 图 形 表示 如 图 4-19 所 示 。 


图 4-19 Camel 任务 


Camel 任 务 和 邮件 任务 的 XML 类 似 ， 都 是 在 serviceTask 的 基础 上 由 Activit 示 展 而 来 ， 代 码 清单 4-20 列 出 了 Camel 的 XML 描述 。 


代码 清单 4-20 Camel 任 务 的 XML 描述 


<serviceTask id= "camelTaskl" name="Camel Task" activiti:delegateExpression="${camel}" /> 


在 代码 清单 4-20 中 定义 了 一 个 Camel 任 务 ， 通 过 属性 activiti:delegateExpression 指 定 一 个 Camel 的 上 下 文 对 象 ，${camel} 表 示 由 Activiti 调 用 名 称 为 camel 的 Bean 对 象 处 理 Camel 任 务 ， 它 可 以 定义 在 
Activit 配 置 文件 中 或 由 Spring 代理 。 


4.3.8 ”Moule 任务 

Moule 任务 外 是 由 MuleSoft 开 发 的 一 款 轻 量 级 开源 ESB (Enterprise System Bus， 企 业 系统 总 线 ) 产品 ， 和 Camel 任 务 功能 类 似 ， 但 是 它们 是 基于 不 同 的 标准 实现 的 ，Camel 任 务 是 基于 传统 EIP 实 现 
的 。 在 使 用 方式 上 Camel 任 务 使 用 链 式 编程 配置 路 由 ， 而 Mule 使 用 非 侵 入 (或 者 很 少 侵入 ) 方式 ， 通 过 可 视 化 的 1DE 工 具 使 用 流程 图 模式 配置 路 由 。 

Mule 任 务 和 Camel 任 务 一 样 ， 也 不 是 BPMN 2.0 规 范 的 一 部 分 ，Activiti 针 对 M ule 任 务 进行 了 整合 ， 可 以 直接 在 流程 中 通过 添加 Task 的 方式 调用 M ule 处 理 业务 逻辑 。 


Activiti 对 Camel 的 扩展 使 用 的 是 serviceTask， 而 对 于 Mule 任 务 使 用 另外 一 种 发 送 任务 一 一 sendTask。 


图 4-20 ”Moule 任务 


Mule 任 务 的 图 形 化 表示 使 用 一 个 黑色 填充 的 信封 表示 ， 如 图 4-20 所 示 。 代 码 清单 4-21 列 出 了 M ule 任 务 的 XML 描述 。 


代码 清单 4-21 ”Moule 任务 的 XML 描 述 


<sendTask id="muleTask" activiti:type="mule"> #1 
<extensionElements> 
<activiti:fieldname="endpointUrl"> #2 
<activiti:string>vm://in</activiti:string> 
</activiti:field> 
<activiti:fieldname="language"> #3 
<activiti:string>juel</activiti:string> 
</activiti:field> 
<activiti:fieldname="payloadExpression"> #4 
<activiti:string>"hi"</activiti:string> 
</activiti:field> 
<activiti:fieldname="resultVariable"> #5 
<activiti:string>resultVar</activiti:string> 
</activiti:field> 
</extensionElements> 


</sendTask> 


代码 清单 4-21 中 的 #1 处 定义 activiti:type= “mule” 来 指定 任务 的 类 型 ， 在 extension-Elements 标 签 中 配置 一 系列 调用 M ule 的 参数 。 

代码 清单 4-21 中 的 #2 处 字段 endpointUrl 指 定 了 协议 类 型 为 vm ， 类 似 Java 虚 拟 机 ， 还 可 以 指定 其 他 的 协议 调用 Mule， 例 如 JMS 或 其 他 的 远程 访问 协议 。 
代码 清单 4-21 中 的 #3 处 字段 language 指 定 了 调用 payloadExpression 的 语言 ， 此 处 指定 为 JUEL。 在 实际 使 用 时 可 以 通过 Activiti 的 任务 变量 动态 设置 。 
代码 清单 4-21 中 的 #4 处 字段 payloadExpression 用 来 指定 Mule 消 息 的 payload 名 称 。 


代码 清单 4-21 中 的 #5 处 字段 resultVariable 用 来 保存 Mule 任 务 的 执行 结果 ， 可 以 通过 Activiti API 获 取 。 
4.3.9 ”手动 任务 


手动 任务 是 比较 特殊 的 任务 之 一 ， 它 不 做 任何 事情 ， 仪 用 来 定义 BPM 不 能 完成 的 任务 ， 需 要 人 工 参 与 建 模 ， 流 程 引擎 无 需 关 心 如 何 处 理 它 ， 因 为 根本 不 需要 处 理 ， 所 以 Activiti 把 手动 任务 当做 一 个 空 任 
务 来 处 理 ， 当 到 达 此 任务 时 由 引擎 自动 完成 并 转向 到 下 一 个 任务 。 


anual |aSsK 


图 4-21 手动 任务 
手动 任务 的 图 形 用 一 个 手 的 图 标 表示 ， 如 图 4-21 所 示 。 代 码 清单 4-22 列 出 了 手动 任务 的 XML 描述 。 


代码 清单 4-22 ”手动 任务 的 XML 摘 述 


<manualTask id="manualTask" name="Manual task" /> 


4.3.10 ”接收 任务 


接收 任务 是 一 个 功能 简单 且 单 一 的 任务 ， 在 任务 创建 之 后 开始 等 待 消息 的 到 来 ， 直 到 被 触发 才 会 完成 任务 。Activiti 实 际 上 把 接收 任务 作为 一 个 Java 类 型 的 接受 任务 ， 仅 能 通过 Runtimeservice 接 口 
的 signal() 方 法 发 送信 号 (signal) 触发 接收 任务 。 原 理 类 似 线程 的 等 待 和 恢复 执行 ， 只 不 过 线程 是 在 内 存 中 操作 ， 而 接受 任务 的 状态 保存 在 数据 库 中 ， 在 调用 Activiti 的 API 触 发 流程 的 接收 任务 后 ， 引 擎 把 
当前 流程 由 等 待 状态 恢复 为 可 执行 状态 。 


接受 任务 的 图 形 使 用 一 个 信封 图 标 表示 ， 如 图 4-22 所 示 。 代 码 清单 4-23 列 出 了 接受 任务 的 XML 描述 。 


图 4-22 ”接收 任务 


代码 清单 4-23 ”接受 任务 的 XML 描 述 


<receiveTask id="receiveTask'" name="Receive task" /> 


4.3.11 Shell 任 务 


Shell 任 务 允 许 在 流程 运行 过 程 中 执行 本 地 操作 系统 中 的 脚本 、 命 令 ， 是 Activiti 基 于 serviceTask 扩 展 的 一 种 任务 (activiti:type= “shell”) 。 在 BPMN 规 范 中 没有 对 应 的 图 形 表示 ，Activiti 添 加 了 Shell 
任务 的 图 形 表示 ， 如 图 4-23 所 示 。 代 码 清单 4-24 列 出 了 Shell 任 务 的 XML 描 述 。 


图 4-23 Shell 任务 


代码 清单 4-24 Shell 任务 的 XML 描述 


<serviceTask id="shellEcho" activiti:type="shell"> 
<extensionElements> 
<activiti:field name="command" stringValue="echo" /> 
<activiti:field name="argl" stringValue="hello" /> 
<activiti:field name="wait" stringValue="true" /> 
<activiti:field name="outputVariable" stringValue="resultVar" /> 
</extensionElements> 
</serviceTask> 


配置 Shell 任 务 的 参数 和 邮件 任务 类 似 ， 使 用 activiti:field 扩 展 元 素 定义 。 表 4-9 列 举 了 代码 清单 4-24 中 Shell 任 务 的 属性 及 其 合 义 。 


表 4-9 ” Shell 任务 的 属性 说 明 


属性 名 称 是 否 必 选 属性 类 型 属性 说 明 默 认 值 


脚本 、 命 令 执行 失败 反馈 的 销 
误 编 码 保存 变量 


在 哪个 目录 执行 脚本 、 命 令 


errorCodeVariable String 


directory String 


属性 类 型 

command 是 执行 的 脚本 、 命 令 
执行 的 时 候 用 空格 分 割 多 个 参数 

wait 否 是 否 等 待 脚本 执行 完成 
redirectError 合并 销 误 输出 至 标准 输出 
cleanEnv 
outputVariable 

Sving 


， 芯 | 基 | 世 | 蕊 


4.3.12 ”多 实例 


多 实例 允许 业务 流程 中 某 一 个 任务 甚至 子 流程 可 以 重复 执行 多 次 ， 在 实际 应 用 中 一 个 申请 由 多 人 审批 是 多 实例 的 典型 应 用 场景 。 多 个 实例 可 以 选择 顺序 执行 ， 还 可 以 选择 并 行 执行 多 实例 任务 或 子 流 


多 实例 图 形 化 描述 是 在 原 任务 的 基础 上 添加 了 3 个 垂直 线 (顺序 执行 ) 和 3 个 平行 线 (并 行 执行 ) 。 图 4-24 和 图 4-25 分 别 展 示 了 顺序 执行 、 并 行 执行 的 不 同 图 形 化 描述 。 


图 4-24 ”顺序 执行 的 多 实例 


图 4-25 并行 执 行 的 多 实例 


多 实例 支持 的 任务 类 型 如 下 : 
.用户 任务 

* 脚本 任务 

.Java Service 任 务 

Web Setrvice 任 务 

. 业务 规则 任务 

` 邮件 任务 

. 手动 任务 

. 接收 任务 


` 子 流程 ( 府 入 式 ) 


` 子 流程 (调用 活动 ) 
全 注意 “网 关 和 事件 类 型 不 支持 多 实例 。 
在 BPMN 2.0 规 范 中 规定 了 多 实例 的 几 个 属性 变量 ， 可 以 通过 execution.getVariable() 获 取 变 量 。 
. hrOfinstances: 实例 的 总 数 。 
. nrOfActivelnstances: 当前 活动 的 (未 完成 的 ) 实例 数量 。 对 于 按照 顺序 执行 的 多 实例 ， 该 值 总 是 为 1。 
. nrOfCompletedlnstances: 已 经 完成 的 实例 数量 。 
` loopCounter: 多 实例 运行 过 程 中 ，for-each 循 环 中 当前 的 索引 值 。 


在 代码 清单 4-25 中 ，#1 处 用 multilnstanceLoopCharacteristics 定 义 了 一 个 多 实例 活动 ， 其 中 isSequential 属 性 可 以 设置 true 和 false 两 个 值 : 值 为 true 时 按照 顺序 执行 ， 值 为 false 时 并 行 执 行 ，#2 处 定义 
了 loopCardinality 标 签 来 指定 多 实例 的 循环 次 数 ， 在 并 行 执行 的 时 候 引 擎 会 一 次 创建 loopCardinality 元 素 值 数 量 的 实例 ， 在 顺序 执行 时 只 有 当 一 个 实例 完成 之 后 才 会 创建 下 一 个 实例 。 


代码 清单 4-25 ”多 实例 的 XML 描述 


<userTask id="audit" name=" 领 导 审 批 "> 

<multiInstanceLoopCharacteristics isSequential="true"> #1 
<loopCardinality>3</loopCardinality> #2 

</multiInstanceLoopCharacteristics> 

</userTask> 


决定 启动 多 少 个 流程 实例 可 以 从 两 个 角度 设置 : 固定 数量 、 任 务 参与 人 列表 。 表 4-10 列 举 了 多 实例 的 配置 元 素 及 属性 。 


表 4-10 ”多 实例 的 配置 元 素 及 属性 


属性 名 称 


loopCardinality 


loopDataInputRef 


inputDataItem 


completionCondition 


isSequential 


属性 说 明 


实例 的 数量 。 可 以 用 常量 设置 ， 
也 可 以 使 用 表达 式 计算 设置 


任务 参与 人 列表 。 以 参与 人 集合 
的 数量 决定 创建 多 少 个 实例 。 和 
loopCardinality 是 互 斥 的 关系 


需要 配合 loopDataInputRef 使 
用 ， 用 来 指定 在 loop-DataInputRef 


中 定义 的 办 理 人 集合 在 循环 过 
程 中 单个 变量 的 名 称 ， 例 如 指 
定 userTask 的 activiti:assignee 属 
性 表示 用 户 任 务 的 办 理 人 由 变量 
assignee 的 值 决定 


多 实例 循环 结束 条 件 。 当 满足 一 
定 条 件 时 退出 多 实例 循环 。 例 如 
在 投票 表决 场景 中 当 通 过 率 达 到 
70% 时 结束 任务 ， 剩 余 未 办 理 的 
任务 不 再 执行 


是 否 按照 顺序 创建 任务 。 值 为 
true 时 表示 按照 顺序 执行 ， 只 有 在 
第 一 个 任务 处 理 完 成 之 后 才 会 继续 
创建 第 二 个 任务 ， 以 此 类 推 ; 值 为 
false 时 表示 不 按照 顺序 执行 ， 而 
是 一 次 创建 多 个 任务 (数量 由 其 他 
的 条 件 决 定 )， 这 样 多 个 任务 可 以 
同时 办 理 ， 也 就 是 并 行 处 理 


另外 Activiti 还 基于 BPMN 2.0 规 范 以 扩展 形式 简化 了 配置 ， 表 4-11 列 举 了 Activiti 扩 展 的 多 实例 属性 。 


示 ” 例 


<userTask id="audit" name=" 领导 审批 "> 
<multilnstanceLoopCharacteristics 
isSequential="false"> 
<loopCardinality>3</loopCardinality> 
</multiInstanceLoopCharacteristics> 
</userTask> 
此 示例 约定 一 次 创建 3 个 任务 ,也 可 以 使 用 UEL 表达 
式 计算 动态 设置 : 
<loopCardinality> 
${allTaskCounter - completedTaskCounter } 
</loopCardinality> 


<userTask id="audit" name=" 领导 审批 "> 
<multilnstanceLoopCharacteristics 

isSequential="false"> 

<loopDatalnputRef> 

assieneeList 

</loopDatalnputRef> 

<inputDataltem name="assignee" /> 
</multilnstanceLoopCharacteristics> 
</userTask> 
assigneeList 作为 一 个 运行 时 变量 存在 ， 实 际 上 是 包含 
了 一 系列 用 户 ID 的 数组 


<userTask activiti:assignee="$ {assignee!"> 
<multiInstanceLoopCharacteristics 
isSequential="false"> 
<loopDataInputRef> 
assigneeL ist 
</loopDatalnputRef> 
<inputDataltem name="assignee" /> 
</multilnstanceLoopCharacteristics> 


</userlask> 


<userTask id="audit" name=" 领导 审批 "> 
<multiIlnstanceLoopCharacteristics 
isSequential="false"> 
<completionCondition> 
${ nrOfCompletedInstances/nrOfInstances 
> = 0.7}! 
</completionCondition> 
</multilnstanceLoopCharacteristics> 
</userTask> 


<userTask id="audit" name=" 任务 分 发 " 

activiti:assignee="henryyan"> 

<multiInstanceLoopCharacteristics 

isSequential="false"> 

<loopCardinality>3</loopCardinality> 

</multilnstanceLoopCharacteristics> 

</userTask> 此 例 在 运行 时 一 次 创建 3 个 任务 并 分 配给 

用 户 henryyan 办 理 。 

当 多 个 领导 办 理会 签 任务 时 需要 设置 为 false 


表 4-11 Activiti 扩 展 的 多 实例 属性 


属性 名 称 属性 说 明 示 例 


<multiInstanceLoopCharacteristics 
用 来 简化 BPMN 2.0 规范 中 的 isSequential="false" 


loopDataInputRef 元 系 activiti:collection="assigneeList"> 


</multiInstanceLoopCharacteristics> 


activiti:collection 


<multiInstanceLoopCharacteristics 
_ ji. isSequential="false" 
用 来 简化 BPMN 2.0 规 范 的 a 0 
| a activiti:collection="assigneeL1st 
inputDataltem 几 了 条 "pT 二 i 9 11 
activiti:elementVariable="assignee"> 
</multiIlnstanceLoopCharacteristics> 


activiti:elementV ariable 


1] http://jcp.org/en/jst/detail?id=223 


[ 
[2] J]Boss 开 发 的 开源 规则 引擎 ,http:www.jboss.org/drools 


[3] http://camel.apache.org/ 
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[4] http:/ /www.mulesoft.org/ 


4.4 网 天 


网 关 (Gateway) 用 于 控制 流程 走向 (在 BPMN 2.0 规 范 中 称 为 “执行 令 牌 ”) 。 根 据 功 能 不 同 可 以 划分 为 以 下 4 种 网 天 : 


. 排他 网 关 
. 并 行 网 关 
. 包容 网 关 


. 事件 网 关 
4.4.1 排他 网 关 


排他 网 关 (Exclusive Gateway， 也 称 做 XOR Gateway) 用 来 对 流程 中 的 决定 进行 建 模 。 流 程 执行 到 该 网 关 时 ， 按 照 输出 流 的 顺序 逐个 计算 ， 当 条 件 计 算 结果 为 true 时 ， 继 续 执行 当前 网 关 的 输出 流 。 


值得 注意 的 是 ， 在 排他 网 关中 ， 如 果 多 个 线路 的 计算 结果 都 为 true， 那 么 只 会 执行 第 一 个 值 为 true 的 网 关 ， 和 忽略 其 他 表达 式 的 值 为 true 的 网 关 。 如 果 多 个 网 关 计算 结果 没有 为 true 的 值 ， 则 引擎 会 抛 出 


一 及- 一 
于 中 。 


排他 网 关 的 图 形 表示 形象 地 在 萎 形 嵌入 “X”， 如 图 4-26 所 示 。 代 码 清单 4-26 列 出 了 排他 网 关 的 XML 描 述 。 


代码 清单 4-26 排他 网 关 的 XML 描述 


<exclusiveGateway id="exclusiveGateway" default=" 


flow1"/> 


排他 网 关 需 要 和 条 件 顺序 流 配 合 使 用 ， 一 个 排他 网 关 可 以 连接 多 个 条 件 顺序 流 ， 


所 示 ， 对 应 的 XML 描 述 如 代码 清单 4-27 所 示 。 


图 4-26 ”排他 网 关 


每 个 条 件 顺 序 流 设置 一 个 条 件 在 运行 时 由 引擎 计算 并 根据 结果 是 否 为 true 决 定 执行 与 否 。 典 型 的 排他 网 关 用 例如 图 4-27 


Stiype == 3) 


图 4-27 典型 的 排他 网 关 用 例 


代码 清单 4-27 图 4-27 对 应 的 XML 描 述 


<exclusiveGatewayid="exclusivegatewayl" name="Exclusive Gateway" default="flow2"> #1 
</exclusiveGateway> 


<sequenceFlow id="flowl" name="" sourceRef="starteventl" targetRef="exclusivegatewayl"> 
</sequenceFlow> 

<userTask idq="usertaskl1" name=" 任 务 一 "></userTask> 

<sequenceFlow id="flow2" name="${type == 1}" sourceRef="exclusivegatewayl" #2-S 
targetRef="usertaskl"> 


<conditionExpression xsi:type="tFormalExpression"> 
<! [CDATA[S{type == 1}]]> 
</conditionExpression> 
</sequenceFlow> #2-E 
<userTask idq="usertask2" name=" 任 务 二 "></userTask> 
<sequenceFlow id="flow3" name="${type == 2}" sourceRef="exclusivegatewayl" #3-S 
targetRef="usertask2"> 
<conditionExpression xsi:type="tFormalExpression"> 
<! [CDATA[${type == 2}]]> 
</conditionExpression> 
</sequenceFlow> #3-E 
<userTask id="usertask3" name=" 任 务 三 "></userTask> 
<sequenceFlow id="flow4" name="${type == 3}" sourceRef="exclusivegatewayl" #4-S 
targetRef="usertask3"> 
<conditionExpression xsi:type="tFormalExpression"> 
<! [CDATA[S{type == 3}]]> 
</conditionExpression> 
</sequenceFlow> #4-E 


代码 清单 4-27 中 的 #1 处 使 用 exclusiveGateway 定 义 了 排他 网 关 ， 并 且 设 定 id 属 性 为 exclusive gatewayl，#2、#3、 #4 分 别 定 义 了 3 个 条 件 顺 序 流 (4.2.2 节 ) 并 统一 设置 了 sourceRef 属 性 为 exclusive gateway1， 
以 此 和 排他 网 关 进 行 关联 。 


当 所 有 的 条 件 都 不 满足 时 ， 排 他 网 关 会 默认 执行 exclusiveGateway 的 default 属 性 指定 的 条 件 顺 序 流 (此 时 已 经 忽略 了 默认 流 的 条 件 ) 。 读 者 可 以 用 ifhttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach ebook/uncompressed/15030/OEBPS/Text/...else ifhttp://www.hzcourse.com/resource/readBook? 


path=/openresources/teach ebook/uncompressed/15030/OEBPS/Text/...else 方 式 理解 排他 网 关 。 


4.4.2 并行 网 天 


并 行 网 关 用 来 对 并 发 的 任务 进行 流程 建 模 ， 它 能 把 单条 线路 任务 拆 分 (fork) 成 多 个 路 径 并 行 执行 或 将 多 条 线路 合并 (join) 。 


并 行 网 关 的 图 形 化 表示 是 在 凌 形 中 嵌入 一 个 加 号 “+ ”， 如 图 4-28 所 示 ， 对 应 的 XML 描述 如 代码 清单 4-28 所 示 。 


图 4-28 “并行 网 关 


代码 清单 4-28 并行 网 关 的 XML 描述 


fork" name="Parallel Gateway Fork"> 


<parallelGateway iqd=" 
</parallelGateway> 


并 行 网 关 的 功能 取决 于 输入 、 输 出 顺序 流 。 
. 拆 分 : 并 行 执行 所 有 的 输出 顺序 流 ， 并 且 为 每 一 条 顺序 流 创建 一 个 并 行 执 行 线 路 。 


` 合并 : 所 有 从 并 行 网 关 拆 分 并 执行 完成 的 线路 均 在 此 等 候 ， 直 到 所 有 的 线路 都 执行 完成 才 继 续 向 下 执行 。 


局 注 意 ”并 行 网关 不 会 计算 线路 上 设置 的 条 件 ， 如 果 设 置 了 ， 则 会 被 直接 忽略 。 
并 行 网 关 的 图 形 化 表示 和 排他 网 关 类 似 ， 把 “X” 换 成 了 “+ ”， 加 号 为 逻辑 “与 ”关系 运算 符 。 典 型 的 并 行 网 关 用 例如 图 4-29 所 示 。 代 码 清单 4-29 列 出 了 图 4-29 对 应 的 XML 描述 。 


[#) 
部 门 领 导 审批 


图 4-29 ”典型 的 并 行 网 关 用 例 


代码 清单 4-29 图 4-29 对 应 的 XML 描述 


<parallelGateway id="fork" name="Parallel Gateway Fork"></parallelGateway> #1 
<userTask id="usertaskl"” name=" 部 门 领导 审批 "></userTask> 
<userTask idq="usertask2" name=" 人 事 审批 "></userTask> 
<parallelGateway id="join" name="Parallel Gateway Join"></parallelGateway> #2 
<userTask id="usertask3"” name=" 考 勤 归 档 "></userTask> 

<endEvent id="endeventl1l" name="End"></endEvent> 


<userTask idq="usertask4" name=" 请 假 申 请 "></userTask> 

<sequenceFlow id="flow2" name="" sourceRef="usertask4" targetRef="fork"/> 
<sequenceFlow id="flow3" name="" sourceRef="fork" targetRef="usertaskl"/> #3 
<sequenceFlow id="flow4" name="" sourceRef="fork" targetRef="usertask2"/> #4 
<sequenceFlow id="flow5" name="" sourceRef="usertaskl" targetRef="join"/> #5 
<sequenceFlow id="flow6" name="" sourceRef="usertask2" targetRef="join"/> #6 
<sequenceFlow id="flow/" name="" sourceRef="join" targetRef="usertask3"/> 
<sequenceFlow id="flow8" name="" sourceRef="usertask3" targetRef="endevent1"/> 
<sequenceFlow id="flow9" name="" sourceRef="starteventl" targetRef="usertask4"/> 


代码 清单 4-29 是 并 行 网 关 的 基本 表现 形式 ， 在 #1 处 的 parallelGateway 描 述 一 个 并 行 网 关 ，id 属 性 为 fork， 拆 分 出 两 条 线路 (#3、#4 处 ) ; 两 个 用 户 任务 全 部 执行 完 之 后 在 #2 处 合并 ， 到 此 完成 了 一 个 fork 
和 join 的 过 程 。 


并 行 网 关 还 允许 在 线路 上 刻 套 并 行 网 关 ， 也 就 是 在 fork 拆 分 的 线路 上 再 添加 n 个 fork 线 路 ， 只 要 保证 最 后 有 一 个 join 点 合并 拆 分 的 线路 即 可 。 图 4-30 展 示 了 钨 套 并 行 网 关 。 


[| 
部 门 领导 审批 


i 


| 


请 假 申 请 考勤 归档 


图 4-30 ” 座 套 并 行 网 关 
图 4-30 中 的 并 行 网 关 有 3 个 ， 所 有 并 行 网 关 不 需要 “成 对 出 现 ”， 保 证 “有 始 有 终 ” 即 可 。 


如 果 一 个 并 行 网 天 有 多 个 输入 、 输 出 流 ， 那 么 它 同时 具备 fork 和 join 的 功能 ， 对 于 这 样 的 并 行 网 关 ， 首 先 会 合并 被 拆 分 的 并 行 网 天 线路 ， 然 后 再 拆 分 合并 网 关 之 后 的 线路 。 图 4-30 中 “部门 领导 审 
批 ” 和 “人 事 审批 ”节点 之 后 的 并 行 网 天 就 是 如 此 ， 假 如 “部 门 领 导 审 批 ”节点 先 执行 完成 ， 此 时 到 达 “ 考 勤 归档 ”节点 前 面 的 并 行 网 天 ， 直 到 “人 事 审批 ”节点 执行 完成 之 后 才 拆 分 后 续 的 “考勤 归 
档 ” 网 关 。 


4.4.3 包容 网 关 


包容 网 关 融 合 了 排他 网 关 和 并 行 网 关 的 特性 ， 排 他 网 关 人 允许 在 每 条 线路 上 设置 条 件 ， 并 行 网 关 可 以 同时 执行 多 条 线路 ， 包 容 网 关 既 可 以 同时 执行 多 条 线路 ， 又 允许 在 网 关上 设置 条 件 。 


包容 网 关 的 图 形 表示 形象 地 在 菱形 中 岩 入 “ 圆 ”， 其 相关 的 输出 流 均 会 被 执行 ， 如 图 4-31 所 示 ， 对 应 的 XML 描 述 如 代码 清单 4-30 所 示 。 


图 4-31 包容 网 关 


代码 清单 4-30 ”包容 网 关 的 XML 描 述 


<inclusiveGateway igd="inclusivegatewayl" name="Inclusive Gateway Fork"> 
</inclusiveGateway> 


和 并 行 网 关 一 样 ， 包 容 网 关 的 功能 也 取决 于 输入 、 输 出 顺序 流 。 
拆 分 : 计算 每 条 线路 上 的 表达 式 ， 当 表达 式 计算 结果 为 tue 时 ， 创 建 一 个 并 行 线路 并 继续 执行 。 
` 合并 : 所 有 从 并 行 网 关 拆 分 并 执行 完成 的 线路 均 在 此 等 候 ， 直 到 所 有 的 线路 都 执行 完 才 继续 向 下 执行 。 
图 4-32 定 义 了 一 个 包容 网 关 版 本 的 请 假 流程 ， 该 流程 在 启动 的 时 候 根据 条 件 顺序 流 判 断 是 否 需要 领导 或 人 事 审批 ， 如 果 两 个 条 件 都 满足 ， 则 “部 门 领导 审批 ”和 “人 事 审批 ”任务 都 会 被 创建 。 


图 4-32 是 并 行 网 关 的 基本 表现 形式 (和 并 行 网 关 类 似 ) ， 用 inclusiveGateway 描 述 一 个 并 行 网 和 天， 有 一 个 fo 汪 开 始点 拆 分 条 件 表达 式 计算 结果 为 true 的 线路 ， 在 最 后 一 个 join 点 合并 在 fo 水 点 拆 分 的 两 条 线 
路 。 代 码 清单 4-31 列 出 了 图 4-32 对 应 的 XML 描 述 。 


Em 


再 要 部 门 领导 审批 
部 门 领导 审批 


地 


考勤 归档 


需要 人 事 审批 ? 


代码 清单 4-31 图 4-32 对 应 的 XML 描 述 


<inclusiveGateway id="igFork" name="Inclusive Gateway Fork"></inclusiveGateway> #1 
<inclusiveGateway id="igJoin" name="Inclusive Gateway Join"></inclusiveGateway> #2 
<userTask id="usertaskl"” name=" 部 门 领导 审批 "></userTask> 

<userTask id="usertask2" name=" 人 事 审批 "></userTask> 

<userTask id="usertask3"” name=" 考 勤 归 档 "></userTask> 

<endEvent id="endeventl1l" name="End"></endEvent> 
<userTask idq="usertask4" name=" 请 假 申 请 "></userTask> 


<sequenceFlow id="flow2" name="" sourceRef="usertask4" targetRef=" igFork "/> 
<sequenceFlow id="flow3" name=" 需 要 部 门 领导 审批 ? " sourceRef=" igFork " #3-S 
targetRef="usertask1l"> 


<conditionExpression xsi:type="tFormalExpression"> 
<! [CDATA[$ {leader == 七 Tue}] ]> 
</conditionExpression> 
</sequenceFlow> #3-E 
<sequenceFlow idq="flow4" name=" 需 要 人 事 审批 ? " sourceRef=" igFork " #4-S 
targetRef="usertask2"> 
<conditionExpression xsi:type="tFormalExpression"> 
<![CDATAI[${hr == true}]]> 
</conditionExpression> 


= 


</sequenceFlow> #4-E 


<sequenceFlow id="flow5" name="" sourceRef="usertaskl" targetRef=" igJoin "/> #5 
<sequenceFlow id="flow6" name="" sourceRef="usertask2" targetRef=" igJoin "/> #6 
<sequenceFlow id="flow/" name="" sourceRef="inclusivegateway2" targetRef= "usertask3"/> 
<sequenceFlow id="flow8" name="" sourceRef="usertask3" targetRef="endevent1"/> 
<sequenceFlow id="flow9" name="" sourceRef="starteventl" targetRef="usertask4"/> 


代码 清单 4-31 中 的 #1 处 定义 了 fork 类 型 的 包容 网 关 ; #2 处 定义 了 join 类 型 的 包容 网 关 ; #3、#4 分 别 是 id 为 ieFork 的 包容 网 关 的 两 个 条 件 顺序 流 ， 在 根据 条 件 执行 完 两 个 用 户 任 务 之 后 汇总 #5、#6 两 个 输 
出 流 到 #2 处 。 


对 比 代码 清单 4-31 和 代码 清单 4-30 可 以 友 现 ， 两 者 唯一 的 不 同 就 是 包容 网 关中 的 顺序 流 可 以 添加 条 件 并 在 运行 时 可 以 被 引擎 解析 ; 并 行 网 关 不 支持 条 件 ， 就 算 设 置 了 条 件 也 会 被 引擎 忽略 掉 。 


4.4.4 事件 网 天 


事件 网 关 是 专门 为 中 间 捕 获 事 件 (4.6.2 节 ) 设置 的 ， 它 允许 设置 多 个 输出 流 指向 多 个 不 同 的 中 间 捕 获 事 件 (最 少 两 个 ) 。 在 流程 执行 到 事件 网 关 后 ， 流 程 处 于 “等 待 ”状态 ， 因 为 中 间 捕 获 事 件 需要 依 
赖 中 间 抛 出 事件 (4.6.3 节 ) 触发 才能 更 改 “ 等 待 ”状态 为 “活动 ”状态 ， 当 然 ， 定 时 器 捕获 事件 除外 ( 它 由 时 间 驱 动 ) 。 


事件 网 关 的 图 形 化 表示 是 在 萎 形 中 嵌入 了 一 个 特殊 符号 ( 双 线 圆 中 绕 套 一 个 多 边 形 ) ， 如 图 4-33 所 示 ， 对 应 的 XML 摘 述 如 代码 清单 4-32 所 示 。 


代码 清单 4-32 事件 网 关 的 XML 描 述 


<eventBasedGateway id="eventgatewayl" name="] 


图 4-33 ”事件 网 关 


Event Gateway"></eventi] 


BasedGateway> 


图 4-34 展 示 了 事件 网 关 的 典型 应 用 ， 其 对 应 的 XML 描 述 如 代码 清单 4-33 所 示 。 


定时 任务 被 触发 后 执行 


捕获 到 信号 事件 后 执行 


图 4-34 ”事件 网 关 的 典型 应 用 


代码 清单 4-33 ”图 4-33 对 应 的 XML 描 述 


<signal id="alertSignal" name="alert"></signal> 
<process id="EventGateway" name="EventGateway"> 
<startEvent id="starteventl" name="Start"></startEvent> 
<eventBasedGateway id="eventgatewayl" name="Event Gateway"></eventBasedGateway> #1 
<intermediateCatchEvent igd="timerintermediatecatcheventl" name="TimerCatchEvent"> #2-S 
<timerEventDefinition> 
<timeDuration>PT1S</timeDuration> 
</timerEventDefinition> 
</intermediateCatchEvent> #2-E 
<scriptTask id="scripttaskl" name=" 定 时 器 任务 执行 之 后 " scriptFormat="groovy"> 
<script><! [CDATA[out:println "after time event";]]></script> 


</scriptTask> 
<intermediateCatchEvent id="signalintermediatecatcheventl" name="SignalCatchEvent"> 
#3-S 

<signalEventDefinition signalRef="alertSignal"></signalEventDefinition> 


</intermediateCatchEvent> #3-E 
<scriptTask idq="scripttask2" name=" 信 号 捕获 事件 之 后 " scriptFormat="groovy"> 
<script><! [CDATA[out:println "after signal event";]]></script> 


</scriptTask> 

<endEvent id="endevent2" name="End"></endEvent> 

<sequenceFlow igd="flowl" name="" sourceRef="starteventl1" 
targetRef="eventgatewayl"></sequenceFlow> 

<sequenceFlow id="flow2" name="" sourceRef="eventgatewayl" 
targetRef="timerintermediatecatchevent1"></sequenceFlow> 

<sequenceFlow id="flow3" name="" sourceRef="timerintermediatecatcheventl" targetRef="scripttask1l"/> 

<sequenceFlow id="flow4" name="" sourceRef="scripttaskl" targetRef="endevent2"/> 

<sequenceFlow id="flow5" name="" sourceRef="eventgatewayl" 


targetRef="signalintermediatecatchevent1"></sequenceFlow> 


上 a 

<sequenceFlow igd="flow6" name="" 
sourceRef="signalintermediatecatchevent1" 
targetRef="scripttask2"></sequenceFlow> 

<sequenceFlow id="flow/" name="" sourceRef="scripttask2" 
targetRef="endevent2"></sequenceFlow> 

</process> 


代码 清单 4-33 首 先 在 #1 处 定义 了 一 个 事件 网 关 (eventBasedGateway) ， 分 别 指向 两 个 输出 流 (对 应 #2、#3) ， 分 别 为 定时 器 中 间 捕 获 事件 (4.6.2 节 ) 和 信号 中 间 捕 获 事件 (4.6.2 节 ) ， 在 流程 启动 之 
后 两 个 输出 流 均 处 于 “等 待 ”状态 。 定 时 器 中 间 事 件 通 过 timeDuration 指 定 定时 器 在 1 秒 钟 之 后 执行 ， 信 号 中 间 事 件 设置 了 signalRef="alertSignal"， 等 待 其 他 流程 中 的 信号 抛 出 事件 抛 出 alertSignal 的 信号 。 
中 间 捕 获 事件 在 满足 了 条 件 后 会 被 自动 触发 继续 执行 输出 流 的 活动 。 


关于 事件 网 和 天 ， 需 要 注意 几 点 : 


* 事件 网 关 的 输出 流 数量 必须 大 于 2 个 。 


. 事件 网 关 的 输出 流 类 型 只 能 是 中 间 捕 获 事件 ，Activiti 不 支持 接受 任务 (4.3.10 节 ) 后 面 的 事件 网 关 。 


` 中 间 捕 获 事件 的 输出 流 只 能 有 一 个 。 


4.5” 子 流程 与 调用 活动 


在 实际 的 企业 应 用 中 ， 业 务 流程 往往 比较 复杂 ， 仔 细 分 析 之 后 一 般 可 以 将 其 划分 为 多 个 不 同 的 阶段 ， 可 以 把 这 些 阶段 规划 为 一 个 子 流程 作为 主流 程 的 一 部 分 ，BPMN 2.0 的 子 流程 规范 正 是 满足 此 需求 
的 选择 之 一 。 


在 企业 中 还 有 一 些 通 用 的 业务 流程 ， 例 如 ， 付 款 流程 作为 公司 业务 运作 的 核心 流程 之 一 ， 在 业务 设计 及 架构 设计 上 会 保持 通 通用 的 模块 ， 不 同 的 业务 根据 财务 流程 的 规 
范 传 入 指定 的 参数 就 可 以 使 用 付款 流程 。 调 用 活动 的 特点 和 子 流程 类 似 ， 但 是 子 流程 嵌入 在 主流 程 中 ， 要 保持 通用 需要 把 付款 流程 作为 活动 由 主流 程 “ 调 用 ”， 如 此 调用 活动 既 包 含 了 子 流程 的 特性 又 保持 
用 。 


1 一 


4.5.1 子 流程 


子 流程 可 以 包含 BPMN 2.0 规 范 中 的 大 部 分 模型 ， 把 一 系列 需要 处 理 的 任务 归结 到 一 起 ， 作 为 


。 因为 子 流程 嵌入 在 主流 程 中 ， 所 以 也 把 子 流程 称 之 为 “嵌入 式 子 流程 ”。 


子 流 程 需要 把 一 系列 模型 包含 在 一 个 实 线 和 矩形 中 ， 形 成 如 图 4-35 所 示 的 子 流程 ， 对 应 的 XML 摘 述 如 代码 清单 4-34 所 示 。 


付 就 子 流程 


局 


向 银行 付款 


图 4-35 ” 子 流 程 的 应 用 场景 


代码 清单 4-34 ” 子 流程 的 XML 描 述 


<subProcess :id="subprocess1" name=" 付 款 子 流程 "> 


</subProcess> 


对 于 子 流程 BPMN 2.0 对 其 做 了 一 些 限制 。 
` 只 能 且 仅 能 包含 一 个 空 启动 事件 。 
. 至 少 要 有 一 个 结束 事件 (每 个 流程 都 要 “有 始 有 终 ”) 。 
. 在 子 流程 中 顺序 流 不 能 直接 设置 输出 流 到 子 流程 之 外 的 活动 上 ， 如 果 需 要 的 ， 可 以 通过 边界 事件 代替 。 
全 注意 BPMN 2.0 规 范 允 许 子 流程 不 包含 启动 、 结 束 事 件 ， 但 是 目前 Activiti 还 不 支持 ， 所 以 本 书 中 所 有 提 到 的 子 流程 均 包 含 启 动 、 结 束 事件 。 


代码 清单 4-35 ”图 4-35 对 应 的 XML 描述 


<process id="subprocess" name="subprocess"> 

<startEvent id="starteventl" name="Start"></startEvent> 

<userTask igd="usertaskl" name=" 下 单 "></userTask> 

<subProcess idq="subprocess1" name=" 付 款 子 流程 "> # 工 
<startEvent id="startevent2" name="Start"></startEvent> 
<userTask id="usertask2"” name=" 银 行 付款 "></userTask> 
<endEvent id="endeventl" name="End"></endEvent> 
<serviceTask idq="mailtaskl" name=" 发 送 邮 件 通知 " activiti:type="mail"> 


</serviceTask> 
<sequenceFlow id="flow3" name="" sourceRef="startevent2" targetRef="usertask2"/> 
<sequenceFlow id="flow9" name="" sourceRef="mailtaskl" targetRef="endevent1"/> 
<sequenceFlow idq="flow10" name=" 发 送 付款 结果 " sourceRef="usertask2" targetRef="mailtask1"/> 
</subProcess> 井 2 
<sequenceFlow id="flowl" name="" sourceRef="starteventl" targetRef='"usertask1"/> 
<sequenceFlow id="flow2" name="" sourceRef="usertaskl" targetRef="subprocess1"/> 
<endEvent id="endevent2" name="End"></endEvent> 
<sequenceFlow id="flowll" name="" sourceRef="subprocessl" targetRef="endevent2"/> 
</process> 


代码 清单 4-35 中 的 #1 处 使 用 subProcess 包 庄 了 启动 、 结 束 及 用 户 任 务 作为 一 个 子 流程 。 读 者 可 以 把 子 流程 作为 一 个 独立 的 流程 来 理解 ， 只 不 过 有 一 些 限制 和 表现 形式 不 同 而 已 。 在 #2 处 结束 子 流程 。 

在 实际 运行 中 流程 引擎 会 自动 为 主流 程 和 子 流程 建立 关联 关系 ， 子 流程 可 以 通过 API 获 取 主 流程 的 一 些 信息 及 变量 。 

注意 子 流程 不 能 直接 越界 指定 输出 流 ， 也 就 是 说 子 流程 中 的 输出 流 只 能 指向 在 实 线 边框 内 的 活动 ， 如 果 因 为 异常 需要 终止 子 流程 的 执行 可 以 通过 4.6.1 节 介绍 的 边界 事件 处 理 。 

子 流程 同时 也 支持 多 实例 特性 ， 例 如 部 门 领导 为 几 个 业务 员 分 配 任务 ， 而 每 项 任务 都 是 一 个 子 流程 ， 部 门 领导 下 发 任务 之 后 每 个 业务 员 都 会 拥有 一 个 独立 的 子 流程 实例 ， 等 所 有 的 业务 员 都 处 理 完成 之 
后 再 汇总 给 部 门 领导 ， 这 在 第 9 章 中 将 会 详细 讲解 。 


4.5.2 调用 活动 


调用 活动 (Call Activity) 解决 的 问题 是 流程 的 通用 性 。 和 子 流 程 的 作用 一 致 ， 但 是 表现 方式 不 同 ， 使 用 一 个 调用 活动 取代 府 入 子 流程 方式 的 活动 即 可 ， 通 过 创建 一 个 调用 活动 模型 并 指定 外 部 流程 的 ID 
方式 作为 主流 程 的 一 个 子 活动 。 图 4-36 展 示 了 调用 活动 的 图 形 化 表示 ， 对 应 的 XML 描述 如 代码 清单 4-36 所 示 。 


代码 清单 4-36 ”调用 活动 的 XML 描述 


<callActivity id="callactivityl" name="Call Activity" called 


表 4-12 列 出 了 调用 活动 和 子 流程 的 区 别 。 


百 接 通 人 在 
定义 子 流程 


局 动 事件 只 肯 


子 流程 共 至 主流 程 的 所 有 变 划 


表 4-12 子 流 程 与 调用 活动 的 区 别 


子 流 程 


E 流 程 中 ， 使 用 subProcess 


E 使 用 空 司 动 事件 


图 4-37 展 示 了 调用 活动 的 用 例 ， 其 对 应 的 XML 描述 如 代码 清单 4-37 所 示 。 


图 4-36 ”调用 活动 


Element="payment"></callActivity> 


调用 活动 
作为 一 个 普通 的 模型 ， 定 义 外 部 流程 的 ID 


无 任何 限制 ， 被 调用 的 外 部 流程 本 号 就 是 


个 完整 的 流程 


需要 指定 输入 、 输 出 变量 


调用 付款 流程 


代码 清单 4-37 ”图 4-37 对 应 的 XML 描述 


<callActivity id="callactivityl" name=" 调 用 付款 流程 " calLledl 


Element="payment"> 


#1 


图 4-37 调用 活动 的 用 例 


<extensionElements> 
<activiti:in source="amount" target="amount"></activiti:in> #2 


<activiti:out source="paid" target="paid"></activiti:out> #3 
<activiti:out sourceExpression="${payTime}" target="payTime"></activiti:out> #4 
</extensionElements> 
</callActivity> 


代码 清单 4-37 中 调用 了 外 部 的 付款 流程 ， 名 称 为 payment; 指定 了 输入 、 输 出 参数 。 表 4-13 列 出 了 调用 活动 的 属性 及 Activiti 的 扩展 元 素 。 


表 4-13 调用 活动 的 属性 及 Activiti 的 扩展 元 素 


属性 名 称 属性 说 明 示 例 


流程 的 ID ， 对 应 的 流程 应 独立 


<callActivity 1d="callactivity1" 


calledElement 存在 。 见 代码 清单 4.37 中 担 处 name=" 调用 付款 流程 " 
calledElement="payment"> 
<activiti:in source="amount" 
调用 外 部 流程 时 传人 的 变量 ，| target="amount"></activiti:in> 
ae 被 油 用 活动 害 要 获取 主流 程 的 信 D source : 主流 程 中 的 变量 名 称 ， 也 可 以 在 使 用 表 
息 (必须 显示 定义 ， 否 则 不 能 获 单 时 计算 
取 )。 见 代码 清单 4-37 中 要 处 |D target: 在 将 变量 传递 给 调用 活动 时 使 用 的 名 称 ， 
-和 股 和 source 同名 避免 铺 误 的 出 现 
<activiti:in source="amount" 
target="amount"></activiti:1in> 
Er 调用 活动 执行 完成 后 的 结果 。| 口 source : 主流 程 中 的 变量 名 称 ， 也 可 以 在 使 用 表 


见 代 码 清单 4-37 中 #3、#4 处 单 时 计算 

D target : 在 将 变量 传递 给 调用 活动 时 使 用 的 名 称 ， 
一 般 和 source 同名 避免 错误 的 出 现 

4.5.3 ”事件 子 流程 


事件 子 流程 和 子 流程 类 似 ， 把 一 系列 的 活动 归结 到 一 起 处 理 ， 不 同 的 是 事件 子 流程 不 能 直接 启动 ， 而 要 “被 动 ” 地 由 其 他 的 事件 触发 启动 ， 在 图 形 化 表示 上 有 所 不 同 ， 子 流程 使 用 的 是 实 线 边框 ， 而 事 
件 子 流程 使 用 的 是 虚线 矩形 ， 如 图 4-38 所 示 ， 对 应 的 XML 描述 如 代码 清单 4-38 所 示 。 


支付 费用 失败 -完善 账号 信息 


图 4-38 ”事件 子 流程 


代码 清单 4-38 ”事件 子 流程 的 XML 描 述 


<SubProcess idq="eventsubprocess1" name=" 完 善 账号 信息 " triggeredByEvent="true"> 


</subProcess> 


事件 子 流程 在 XML 描 述 上 和 子 流程 不 同 的 是 添加 了 一 个 triggeredByEvent 属 性 表示 此 子 流程 只 能 由 事件 触发 后 被 动 启动 。 
事件 子 流程 在 企业 中 使 用 频率 很 高 ， 它 可 以 由 异常 事件 、 信 号 事件 、 消 息 事 件 、 定 时 器 事件 、 补 偿 事件 等 触 帮 ， 从 而 启动 一 个 子 流程 。 
事件 子 流程 和 子 流程 不 同 ， 子 流程 作为 主流 程 中 输出 流 的 一 个 输出 活动 ， 而 事件 子 流 程 是 独立 在 主流 程 中 的 ， 图 4-39 是 用 付款 业务 模拟 的 一 个 事件 子 流程 的 应 用 场景 。 


图 4-38 的 用 例 在 支付 失败 时 用 排他 网 关 把 输出 流转 向 异常 结束 事件 ， 主 流程 中 的 “支付 费用 失败 一 一 完善 账号 信息 ”作为 一 个 异常 处 理子 流程 存在 ， 在 4.1.1 和 4.1.2 中 分 别 讲解 了 异常 启动 事件 和 异常 结 
束 事件 ， 此 例 也 恰好 演示 了 两 者 的 联合 应 用 。 


加 注意 异常 结束 事件 和 异常 启动 事件 的 ettotRef 要 保持 一 直 。 如 果 主 流程 中 有 多 个 异常 可 以 添加 多 个 事件 子 流 程 ， 那 么 要 分 别处 理 。 


支付 成 功 


支付 失败 


支付 费用 失败 -完善 账号 信息 : 


站 
a 
a 
里 
可 
午 


图 4-39 ”用 付款 业务 模拟 的 一 个 事件 子 流 程 的 应 用 场景 


代码 清单 4-39 图 4-39 对 应 的 XML 描述 


<process id="processl" name="processl1"> 
<startEvent id="starteventl" name="Start"></startEvent> 


<endEvent id="endevent3" name="ErrorEnd"> 
<errorEventDefinition errorRef="A002"></errorEventDefinition> #1 
</endEvent> 


</process> 
<subProcess id="eventsubprocessl1" 
name=" 支 付费 用 失败 -- 完 善 账 号 信息 " triggeredByEvent="true"> #2 


<startEvent id="errorstarteventl" name="Error start"> 
<errorEventDefinition errorRef="A002"></errorEventDefinition> #3 

</startEvent> 

<userTask idq="usertask2" name=" 完 善 账 号 信息 "></userTask> 


<sequenceFlow id="flow6" name="" sourceRef="errorstarteventl" targetRef ="usertask2"/> 
<endEvent id="endevent4" name="End"></endEvent> 
<sequenceFlow id="flow/" name="" sourceRef="usertask2" targetRef="endevent4"/> 


</subProcess> 


代码 清单 4-39 中 的 #2 处 通过 在 subProcess 标 签 添 加 属性 triggeredByEvent=true 定 义 了 一 个 事件 子 流程 ，#1 处 使 用 一 个 异常 结束 事件 (4.1.2 节 ) 抛 出 异常 ，#3 处 用 来 捕获 一 个 异常 事件 ， 因 为 errorRef 的 值 
为 “A002”,， 所 以 当主 流程 “process1” 执 行 到 ID 为 “endevent3” 的 异常 结束 事件 时 引擎 会 启动 子 流程 “eventsubprocess1”。 注 意 代码 清单 4-39 中 加 粗 的 部 分 ， 错 误 编 号 要 保持 一 致 。 


付款 〈 事 务 ) 子 流程 


图 4-40 ”事务 子 流程 


4.5.4 ”事务 子 流程 


事务 子 流程 也 称 为 “事务 块 ”， 用 来 处 理 一 组 必须 在 同一 个 事务 中 完成 的 活动 ， 这 些 活动 要 么 一 起 成 功 ， 要 么 一 起 失败 。 事 务 子 流程 中 的 活动 具有 ACIDI'] (数据 库 事务 的 4 个 特性 ) 特性 ， 如 果 其 中 有 
一 个 活动 失败 或 取消 ， 则 整个 事务 子 流程 的 所 有 活动 全 部 回 滚 。 


事务 子 流程 的 图 形 化 表示 采用 双 线 矩形 ， 如 图 4-41 所 示 ， 对 应 的 XML 描述 如 代码 清单 4-40 所 示 。 


代码 清单 4-40 ”事务 子 流程 的 XML 描述 


<transaction id="myTransaction" > 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15030/0EBPS/Text/... 


</transaction> 


图 4-41 展 示 了 事务 子 流程 的 一 个 应 用 场景 一 一 银行 汇款 。 


付款 〈 事 务 ) 子 流程 


各 二 全 
| 从 付款 方 扣 除 金 额 _ 癌 受 球 方 账户 汇 球 


汇款 成 功 


银行 汇款 


图 4-41 事务 子 流程 应 用 场景 


图 4-41 模 拟 了 一 个 简单 的 银行 汇款 流程 ， 在 主流 程 中 嵌入 了 一 个 事务 子 流程 把 汇款 业务 放 在 一 个 事务 中 处 理 。 根 据 事 务 执行 结果 可 以 把 执行 结果 划分 为 以 下 几 种 。 


. 事务 成 功 : 事务 子 流程 中 的 两 个 任务 全 部 成 功 ， 正 常 结束 。 
抛 出 了 异常 ， 接 着 被 附加 在 此 任务 边界 上 的 异常 边界 事件 捕获 ， 然 后 执行 后 续 输 出 流 的 取消 结束 事件 ， 最 后 被 附加 在 事务 子 流程 
”) 。 在 图 4-41 中 ， 在 “向 受 款 方 账户 汇款 ”节点 的 执行 


这 二 士 户 » 


. 事务 取消 : 在 事务 执行 过 程 中 出 现 异 常 ， 任 务 “ 向 受 款 方 账户 汇款 
中 的 取消 边界 事件 捕获 执行 “通知 客户 汇款 失败 ”任务 ; 与 此 同时 会 触发 子 流程 中 的 补偿 边界 事件 执行 事务 取消 的 补偿 逻辑 (任务 “退回 已 扣 金 额 


过 程 出 现 异 常 被 捕获 之 后 执行 取消 结束 事件 〈4.1.2 节 ) ， 随 即 被 附加 在 事务 子 流程 的 取消 边界 事件 (4.6.1 节 ) 捕获 。 


. 事务 失败 : 事务 执行 时 遇 到 不 可 处 理 的 异常 ， 既 不 能 补偿 又 不 能 回 滚 事务 。 在 图 4-41 中 捕获 到 异常 之 后 会 执行 “记录 系统 异常 信息 ”活动 。 


[1] http:/ /zh.wikipedia.org/zh-hk/ACID 


4.6 边界 与 中 间 事 件 


除了 4.1 节 中 提 到 的 启动 和 结束 事件 之 外 ， 中 间 事 件 提供 的 特殊 功能 可 以 用 来 处 理 流程 执行 过 程 中 抛 出 、 捕 获 的 事件 ， 具 体 包括 边界 事件 、 中 间 捕 获 事件 、 中 间 抛 出 事件 。 每 种 中 间 事 件 的 图 形 表示 都 有 
一 个 共同 特点 : 以 双 线 圆 形 表示 ， 如 图 4-42 所 示 。 


| 六 


图 4-42 边界 与 中 间 事 件 的 基本 图 形 


4.6.1 边界 事件 


边界 事件 是 绑 定 在 活动 上 的 “捕获 型 ”事件 ， 会 一 直 监 听 所 有 处 于 运行 中 活动 的 某 种 事件 的 触 上 友 ， 在 捕获 到 事件 之 后 中 断 活动 ， 然 后 从 边界 事件 类 型 的 输出 流 继 续 执行 。 
值得 注意 的 是 一 旦 触发 边界 事件 ， 当 前 的 活动 就 会 被 中 断 ， 然 后 按照 边界 事件 之 后 的 输出 流 执 行 。 


边界 事件 和 所 关联 的 活动 有 一 个 特殊 的 关系 “附加 ”， 而 且 一 个 活动 只 能 绑 定 一 个 边界 事件 ; 每 个 边界 事件 类 型 都 是 通过 属性 attachedToRef 指 定 “ 附 加 ”到 抛 出 边界 事件 的 活动 上 。 


代码 清单 4-41 列 出 了 边界 事件 的 基本 XML 描 述 。 


代码 清单 4-41 ”边界 事件 的 基本 XML 描 述 


<boundaryEvent id="boundary" attachedToRef="someActivity" cancelActivity= "true|false"> 
<xxxxEventDefinition /> 
</boundaryEvent> 


所 有 的 边界 事件 子 类 型 均 需 要 包含 在 bpoundaryEvent 标 签 中 。cancelActivity 属 性 可 以 取 true、false 两 个 值 ， 用 来 指定 在 捕获 到 边界 事件 之 后 是 否 取 消 执行 输出 流 指定 的 活动 ， 不 过 此 属性 仅 适 用 部 分 
边界 事件 ， 在 讲解 过 程 中 会 特别 说 明 。 


1. 定 时 器 边界 事件 


定时 器 边界 事件 和 定时 启动 事件 类 似 ， 只 不 过 两 者 的 应 用 场合 不 同 ， 定 时 启动 事件 用 于 在 一 个 指定 的 时 间 启 动 一 个 新 的 流程 ， 而 定时 器 边界 事件 需要 附属 在 一 个 非 自动 任务 (用 户 任务 等 ) 、 调 用 活 
动 、 子 流程 上 ， 在 上 游 任务 执行 完成 之 后 开始 倒计时 预 设 的 时 间 ， 到 达 预 设 时 间 之 后 触发 定时 器 边界 事件 的 输出 流 (输出 流 可 以 是 并 行 ) 。 


定时 器 边界 事件 的 图 形 化 表示 和 定时 器 启动 事件 类 似 ， 在 边界 事件 的 基础 上 添加 一 个 事件 图 标 ， 如 图 4-43 所 示 。 


图 4-43 ”定时 器 边界 事件 


图 4-44 展 示 了 定时 器 边界 事件 在 请 假 流 程 中 的 应 用 ， 对 应 的 XML 描 述 如 代码 清单 4-42 所 示 。 


国 
部 门 领导 审批 


改 运 提醒 销假 邮件 


图 4-44 ”定时 器 边界 事件 在 请 假 流程 中 的 应 用 


代码 清单 4-42 ”图 4-44 中 定时 器 边界 事件 的 XML 描述 


<boundaryEvent id="boundarytimerl" cancelActivity="false" attachedToRef="hrAudit"> 
<timerEventDefinition> 
<timeDuration>P3D</timeDuration> 
</timerEventDefinition> 
</boundaryEvent> 


对 于 timeDuration 的 设置 可 参考 4.1.1 节 对 定时 启动 事件 的 介绍 。 
2. 异 常 边界 事件 
异常 边界 事件 用 来 捕获 嵌入 子 流程 或 调用 活动 (4.5 节 ) 抛 出 的 异常 。 异 常 在 抛 出 之 后 被 主流 程 的 异常 边界 事件 捕获 ， 同 时 嵌入 子 流程 或 调用 活动 中 的 活动 也 被 中 断 执行 。 


异常 边界 事件 的 图 形 化 表示 是 在 中 间 事 件 的 基础 上 嵌入 了 一 个 “雷电 ”符号 ， 如 图 4-45 所 示 。 


图 4-45 “异常 边界 事件 


图 4-46 展 示 了 一 个 网 上 商场 的 模拟 流程 ， 包 含 了 异常 边界 事件 处 理 。 


付款 子 流程 


Mail Task 


图 4-46 ”网 上 商场 的 模拟 流程 


图 4-46 对 应 的 XML 描 述 如 代码 清单 4-43 所 示 。 


代码 清单 4-43 ”图 4-46 的 子 流 以 及 边界 事件 的 XML 描 述 


<subProcess jid="subprocess1" name=" 付 款 子 流程 "> 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15030/0EBPS/Text/... 
<endEvent id="endevent2" name="ErrorEnd"> #1-S 
<errorEventDefinition errorRef="AO001"> 
</errorEventDefinition> 


</endEvent> #1-E 
</subProcess> 
<boundaryEvent id="boundaryerrorl" cancelActivity="false" #2-S 
attachedToRef="subprocessl"> #2-1 
<errorEventDefinition errorRef="AO01™" /> #2 一 
</boundaryEvent> 


从 代码 清单 4-43 的 #2-1 处 可 以 看 出 ，attachedToRef 指 定 到 了 子 流程 subprocess1， 在 子 流程 中 “银行 付款 ”节点 出 现 异常 之 后 退出 付款 子 流程 ， 紧 接着 被 “附加 ”在 子 流程 的 异常 边界 事件 捕获 并 执 
行 唯一 的 输出 流 “ 处 理 异常 ”任务 ，#1 处 用 于 抛 出 一 个 异常 结束 事件 ，#2 用 于 捕获 一 个 异常 事件 。 


付款 子 流程 的 异常 结束 事件 和 4.1.1 中 的 “异常 启动 事件 ”相同 ， 也 是 通过 errorRef 指 定 错误 类 型 ， 在 本 例 中 ， 在 boundaryEvent 的 errorEventDefinition 元 素 中 定义 了 相同 的 错误 引用 编码 “A001”。 
3. 信 号 边界 事件 
信号 边界 事件 可 以 捕获 流程 执行 过 程 中 抛 出 的 信号 ， 可 以 “附加 ”在 各 种 活动 和 子 流 程 上 。 


信号 边界 事件 不 仅 可 以 捕获 本 流程 的 信号 ， 还 可 以 捕获 到 其 他 流程 的 信号 事件 ， 而 且 如 果 在 一 个 活动 或 子 流程 上 定义 了 多 个 信号 边界 事件 并 监听 同一 个 信号 ， 则 会 同时 触发 ， 因 为 对 应 的 信号 抛 出 事件 


图 4-47 ”信号 边界 事件 


言 号 边界 事件 的 图 形 化 表示 在 边界 事件 的 基础 上 嵌入 了 三 角形 ， 如 图 4-48 所 示 ， 对 应 的 XML 描 述 如 代码 清单 4-44 所 示 。 


代码 清单 4-44 “信号 边界 事件 的 XML 描 述 


<boundaryEvent id="boundary" attachedToRef="task" cancelActivity="true"> 
<signalEventDefinition sigqnalRef="alertSignal"/> 
</boundaryEvent> 


4. 取 消 边 界 事件 
取消 边界 事件 是 专门 针对 事务 子 流程 所 设立 的 ， 用 来 捕获 子 流程 中 抛 出 的 取消 事件 ， 读 者 可 以 结合 4.5.4 节 来 理解 。 


取消 边界 事件 的 图 形 表 示 在 中 间 事 件 的 基础 上 嵌入 空心 的 “X”， 如 图 4-48 所 示 ， 对 应 的 XML 描述 如 代码 清单 4-45 所 示 。 


图 4-48 ”取消 边界 事件 


值得 注意 的 是 ， 取 消 边 界 事件 只 能 和 事务 子 流程 结合 使 用 ， 不 能 附加 在 其 他 的 活动 上 。 


代码 清单 4-45 ”取消 边界 事件 的 XML 描 述 


<boundaryEvent id="boundary" attachedToRef="transaction" > 
<cancelEventDefinition /> 
</boundaryEvent> 


在 结合 事务 子 流程 使 用 时 需要 注意 几 点 : 

. 一 个 事务 子 流程 只 允许 附加 一 个 取消 边界 事件 。 

. 如 果 事 务 子 流程 中 典 套 了 子 流 程 ， 仅 仅 触发 已 经 完成 了 的 子 流程 的 补偿 事件 。 

“ 对 于 多 实例 的 事务 子 流 程 ， 如 果 其 中 一 个 实例 触发 了 取消 事件 ， 那 么 其 他 的 实例 也 同样 会 被 触发 取消 边界 事件 。 


马 注意 ”取消 边界 事件 不 需要 设置 cancelActivity 属 性 ， 因 为 它 总 是 “中 断 ” 取 消 边界 事件 附加 任务 后 续 活动 的 执行 。 


5. 补 偿 边 界 事件 

补偿 边界 事件 用 于 事务 子 流 程 (嵌入 子 流程 不 支持 补偿 边界 事件 ) 中 针对 事务 失败 后 的 业务 逻辑 进行 补偿 。4.5.4 节 中 的 图 4-41 很 清楚 地 说 明了 补偿 边界 事件 的 作用 。 

补偿 边界 事件 的 图 形 化 表示 在 中 间 事 件 的 基础 上 谋 套 了 两 个 左 三 角 符号 。 和 其 他 的 边界 事件 不 同 的 是 ， 补 偿 边 界 事件 的 输出 流 不 是 一 个 顺序 流 而 是 一 个 “关联 ”， 用 虚线 表示 。 如 图 4-49 展 示 了 补偿 边 
界 事件 及 关联 补偿 活动 ， 对 应 的 XML 描 述 如 代码 清单 4-46 所 示 。 


图 4-49 ”补偿 边界 事件 以 及 关联 补偿 活动 


代码 清单 4-46 ”补偿 边界 事件 的 XML 描述 


<boungdaryEvent id="Event 1" name=" 捕 获取 消 结束 事件 " attachedToRef="Task 2"> 

<compensateEventDefinition i d="EventDef 1"/> 

</boundaryEvent> 

<association id="Association 1" sourceRef="Event 1" 
targetRef="Task 4" associationDirection="One"/> 

<serviceTask id="Task 4" name=" 退 回 已 扣 金 额 " isForCompensation="true"/> 


在 代码 清单 4-46 中 ， 用 compensateEventDefinition 表 示 一 个 补偿 事件 ; 用 association 关 联 两 个 对 象 ， 和 顺序 流 类 似 ， 使 用 sourceRef、targetRef 表 示 两 个 关联 的 活动 I[D; 在 serviceTask 中 添加 了 
isForCompensation 属 性 ， 用 来 声明 这 是 一 个 补偿 类 型 的 活动 。 


辕 注意 如 果 补 偿 边界 事件 “附加 ”的 活动 是 多 实例 〈4.3.12 节 ) ， 当 抛 出 补偿 事件 时 ， 每 一 个 实例 都 会 被 触发 补偿 边界 事件 。 


4.6.2 ”中 间 捕 获 事 件 
消息 被 接收 到 之 


oo 


中 间 捕 获 事件 是 流程 中 的 “拦路 虎 ”， 根 据 事件 的 不 同类 型 需要 使 用 不 同 的 方式 才能 继续 执行 后 续 的 输出 流 的 活动 。 例 如 执行 完 一 个 任务 1 天 后 执行 下 一 个 活动 ， 或 者 一 个 指定 的 信号 、 
后 再 执行 后 续 输出 流 的 活动 。 

中 间 捕 获 事 件 在 图 形 表现 形式 上 和 边界 事件 是 有 区 别 的 : 边界 事件 需要 “附加 ”在 一 个 活动 上 ， 而 且 不 需要 输入 流 ;而 中 间 捕 获 事件 必须 连接 一 个 输入 流 和 一 个 输出 流 ， 所 以 根据 这 个 特性 命名 为 中 间 
捕获 事件 。 另 外 ， 所 有 的 中 间 捕 获 事件 的 图 标 都 是 空心 。 

中 间 捕 获 事 件 的 基本 XML 描述 如 代码 清单 4-47 所 示 。 


代码 清单 4-47 ”中 间 捕 获 事 件 的 基本 XML 描 述 


<intermediateCatchEvent id="eventl1"> 
<xxxxEventDefinition /> 
</intermediateCatchEvent > 


1. 定 时 器 中 间 捕 获 事件 


定时 器 中 间 捕 获 事件 和 定时 启动 事件 (4.1.1 节 ) 、 定 时 器 边界 事件 (4.6.1 节 ) 的 功能 、 配 置 参 数 的 方式 都 类 似 ， 都 在 一 个 特定 的 时 间或 指定 间隔 多 长 时 间 之 后 被 触 友 ， 从 而 执行 输出 流 后 面 的 活动 。 代 
码 清单 4-48 列 出 了 定时 器 中 间 捕 获 事件 的 XML 描 述 。 


代码 清单 4-48 ”定时 器 中 间 捕 获 事 件 的 XML 描 述 


<intermediateCatchEvent id="timerintermediatecatcheventl" name="TimerCatchEvent"> 
<timerEventDefinition> 
<timeDuration>PTSM</timeDuration> 
</timerEventDefinition> 
</intermediateCatchEvent> 


定时 器 中 间 捕 获 事件 的 图 形 化 表示 和 定时 器 边界 事件 一 样 ， 唯 一 的 区 分 方式 就 是 在 流程 中 所 处 的 位 置 ， 图 4-50 展 示 了 定时 器 中 间 捕 获 事件 的 应 用 场景 。 


流程 中 止 ，5 分 钟 
后 继续 执行 


图 4-50 ”定时 器 中 间 捕 获 事件 的 应 用 场景 
定时 中 间 捕 获 事件 的 XML 的 描述 方式 和 定时 器 边界 事件 类 似 ， 不 同 的 是 由 intermediateCatchEvent 包 应 timerEventDefinition。 图 4-51 对 应 的 XML 描述 如 代码 清单 4-49 所 示 。 


代码 清单 4-49 图 4-50 对 应 的 XML 描述 


<process id="processl" name="processl1"> 

<startEvent id="starteventl" name="Start"></startEvent> 

<userTask id="usertaskl" name=" 任 务 一 "></userTask> 

<sequenceFlow id="flowl" name="" sourceRef="starteventl" targetRef="usertask1l"/> 

<intermediateCatchEvent id="timerintermediatecatcheventl1" name="TimerCatchEvent"> #1-S 
<timerEventDefinition> 

<timeDuration>PTSM</timeDuration> #1 一 1 

</timerEventDefinition> 

</intermediateCatchEvent> #1-E 

<sequenceFlow id="flow2" name=" 五 分 钟 后 执行 " sourceRef="usertaskl" targetRef="timerintermediatecatchevent1"></sequenceFlow> 


</process> 
在 代码 清单 4-49 中 ，#1-S 处 定义 了 中 间 捕 获 事件 ， 接 着 在 #1-1 处 设置 定时 器 在 5 分 钟 之 后 执行 。 关 于 定时 器 的 不 同方 式 可 参考 4.1.1 节 的 “定时 启动 事件 ”。 
2. 信 号 中 间 捕 获 事件 
言 号 中 间 捕 获 事 件 用 来 捕获 被 当前 流程 或 其 他 流程 抛 出 的 信号 事件 ， 捕 获 的 条 件 就 是 信号 的 ID 一 致 ， 在 4.4.4 节 的 “事件 网 关 ” 中 其 实 已 经 涉及 了 信号 中 间 捕 获 事 件 。 


言 号 中 间 捕 获 事件 的 图 形 化 表示 是 在 中 间 事 件 的 基础 上 嵌入 一 个 空心 三 角 符 号 ， 如 图 4-51 所 示 ， 对 应 的 XML 描述 如 代码 清单 4-50 所 示 。 


图 4-51 ”信号 中 间 捕 获 事件 


代码 清单 4-50 ”信号 中 间 捕 获 事件 的 XML 描述 


<intermediateCatchEvent id="signal"> 
<signalEventDefinition signalRef="doXxxSignal™" /> 
</intermediateCatchEvent> 


代码 清单 4-47 在 intermediateCatchEvent 中 衬 套 了 signalEventDefinition， 并 用 signalRef 属 性 定义 一 个 信号 的 ID。 


图 4-52 展 示 了 一 个 信号 中 间 捕 获 事件 的 应 用 场景 ， 在 “处 理 任务 ”的 用 户 任 务 完成 之 后 ， 流 程 处 于 “等 待 ”状态 ,一 直接 收 到 指定 的 信号 才能 继续 执行 。 


图 4-52 ”信号 中 间 捕 获 事件 的 应 用 场景 


代码 清单 4-51 列 出 了 图 4-52 对 应 的 XML 描述 。 


代码 清单 4-51 图 4-52 对 应 的 XML 描 述 


<signal id="signal-001" name=" 发 送 通 知 信号 "></signal> #1 
<process id="processl" name="processl1"> 


<startEvent id="starteventl" name="Start"></startEvent> 

<sequenceFlow id="flowl" name="" sourceRef="starteventl" targetRef="usertask1l"/> 

<intermediateCatchEvent id="signalintermediatecatcheventl" name="SignalCatchEvent"> #2 

<signalEventDefinition signalRef="signal-001"></signalEventDefinition> 3 

</intermediateCatchEvent> 

<sequenceFlow igd="flow2" name="" sourceRef="usertaskl" 
targetRef="signalintermediatecatchevent1"></sequenceFlow> 

<endEvent id="endeventl1l" name="End"></endEvent> 

<userTask idq="usertask1" name=" 处 理 任务 "></userTask> 

<sequenceFlow id="flow3" name="" sourceRef="signalintermediatecatchevent1" 
targetRef="endevent1"></sequenceFlow> 

</process> 


代码 清单 4-51 在 #1 处 使 用 signal 定 义 了 一 个 id 为 “signal-001” 的 信号 ， 在 #2 处 定义 了 信号 中 间 捕 获 事 件 ， 并 且 在 #3 处 设置 信号 的 引用 为 “signal-001”。 在 第 一 个 “处 理 任务 ”的 用 户 任务 完成 之 后 
通过 输出 流 流转 到 信号 中 间 捕 获 事 件 ， 使 流程 处 于 等 待 状态 ， 在 有 信和 号 被 抛 出 之 后 流程 重新 被 激活 ， 继 续 执行 后 续 活动 。 


有 一 个 地 方 需要 读者 注意 ， 当 抛 出 的 信号 事件 匹配 到 多 个 相同 的 信号 捕获 事件 时 (可 以 是 不 同 流程 ) ， 每 个 匹配 到 的 事件 均 会 被 执行 ， 这 也 被 称 为 “广播 式 ”。 
3. 消 息 中 间 捕 获 事件 
消息 中 间 捕 获 事件 和 信号 中 间 捕 获 事件 类 似 ， 不 同 的 是 信号 事件 是 “广播 式 “ 传 播 ， 而 消息 中 间 捕 获 事件 是 定向 一 对 一 的 传递 ， 也 就 是 说 一 次 只 能 把 一 个 消息 发 给 一 个 指定 的 流程 实例 。 


消息 中 间 捕 获 事件 的 图 形 化 表示 是 在 中 间 事 件 的 基础 上 罕 入 一 个 空心 的 信封 图 标 ， 如 图 4-53 所 示 ， 代 码 清单 4-52 列 出 了 消息 中 间 捕 获 事件 的 XML 描 述 。 


图 4-53 ”消息 中 间 捕 获 事件 


代码 清单 4-52 ”消息 中 间 捕 获 事 件 的 XML 描 述 


<intermediateCatchEvent Idq='"messageCatch"> 
<messageEventDefinition messageRef="continueXxx" /> 
</intermediateCatchEvent> 


代码 清单 4-52 在 intermediateCatchEvent 中 众 套 了 messageEventDefinition ， 并 用 messageRef 属 性 定义 一 个 消息 名 称 。 


图 4-54 展 示 了 一 个 消息 中 间 捕 获 事 件 的 应 用 场景 ， 在 “处 理 任务 ”的 用 户 任务 完成 之 后 ， 流 程 处 于 “等 待 ”状态 ， 一 直接 收 到 指定 名 称 的 消息 才能 继续 执行 。 


处 理 任 务 


图 4-54 ”消息 中 间 捕 获 事件 的 应 用 场景 


代码 清单 4-53 ”图 4-55 对 应 的 XML 描 述 


<message id="newInvoice" name="newInvoiceMessage" /> #1 
<process id="process"> 
<startEvent id="thesStart" /> 
<sequenceFlow id="flowl" sourceRef="theStart" targetRef="messageCatch" /> 


<intermediateCatchEvent id="messageCatch"> #2 
<messageEventDefinition messageRef="newInvoice" /> #3 

</intermediateCatchEvent> 
<sequenceFlow id="flow2" sourceRef="messageCatch" targetRef="task" /> 
<userTask id="task" name=" 处 理 任务 " /> 
<sequenceFlow id="flow3" sourceRef="task" targetRef="theEnd" /> 
<endEvent id="theEnd" /> 

</process> 


代码 清单 4-53 在 #1 处 使 用 message 定 义 了 一 个 id 为 “newlnvoice” 的 消息 ， 在 #2 定义 了 消息 中 间 捕 获 事件 ， 并 且 在 #3 处 设置 消息 的 引用 为 “newlnvoice”。 在 第 一 个 用 户 任 务 “ 处 理 任务 ”完成 之 
后 ， 通 过 输出 流 流转 到 消息 中 间 捕 获 事件 ， 使 流程 处 于 等 待 状态 ， 当 此 流程 实例 收 到 消息 之 后 ， 流 程 重新 被 激活 继续 执行 后 续 活 动 〈 因 为 消息 事件 是 一 对 一 方式 传播 ) 。 


4.6.3 中间 抛 出 事件 
中 间 抛 出 事件 和 中 间 捕 获 事 件 是 两 个 相互 依赖 的 关系， 中间 捕获 事件 需要 有 事件 抛 出 才能 被 触发， 而 中 间 抛 出 事件 需要 有 对 应 的 捕获 事件 接收 才 有 意义 。 
中 间 抛 出 事件 一 般 用 在 一 个 任务 完成 后 需要 发 送 通知 或 执行 其 他 系统 任务 的 场景 ， 工 作 流 引 警 会 对 抛 出 的 事件 进行 传播 (不 同类 型 的 事件 有 不 同 的 作用 范围 ) 。 
中 间 抛 出 事件 的 图 形 化 表示 和 中 间 捕 获 事 件 正 好 相反 ， 使 用 实心 的 图 标 而 非 中 间 捕 获 事件 的 空心 图 标 。 
中 间 抛 出 事件 的 基本 XML 表示 如 代码 清单 4-54 所 示 。 


代码 清单 4-54 ”中 间 抛 出 事件 的 基本 XML 描 述 


< jntermediateThrowEvent id="eventl1"> 
<xxxxEventDefinition /> 
</ intermediateThrowEvent > 


1. 空 中 间 抛 出 事件 


空中 间 抛 出 事件 是 BPMN 2.0 规 范 中 没有 任何 功能 的 事件 ， 因 此 执行 到 空中 间 抛 出 事件 时 直接 跳 过 。 从 业务 层面 对 其 理解 ， 可 以 把 它 作 为 中 间 状 态 、 结 果 的 处 理 器 ， 这 就 要 借助 Activiti 的 扩展 功能 来 实 
现 了 ， 可 以 为 它 添加 到 监听 器 (4.7 节 ) 中 执行 我 们 预 设 的 业务 功能 。 


图 4-55 空中 间 抛 出 事件 


空中 间 抛 出 事件 的 图 形 化 表示 和 中 间 事 件 的 基础 形状 一 样 ， 仅 仅 只 有 一 个 双 层 圆 形 ， 如 图 4-55 所 示 ， 对 应 的 XML 拉 述 如 代码 清单 4-55 所 示 。 


代码 清单 4-55 ”空中 间 抛 出 事件 的 XML 描 述 


<intermediateThrowEvent id="noneintermediatethroweventl" name="NoneThrowEvent"> 
</intermediateThrowEvent> 


从 代码 清单 4-55 可 以 看 出 ， 仅 仅 使 用 一 个 intermediateThrowEvent 标 签 即 可 描述 一 个 空中 间 抛 出 事件 ， 在 标签 内 部 不 需要 定义 任何 其 他 子 元 素 。 


读者 可 能 会 问 : 这 样 的 事件 有 何 作用 呢 ”BPMN 是 用 语言 方式 描述 业务 逻辑 ， 明 确 地 告知 用 户 流程 的 流向 及 每 一 步 的 处 理 任务 ， 空 中 间 抛 出 事件 虽然 是 一 个 空 的 任务 ， 但 是 可 以 借助 Activiti 对 大 多 数 活 
、 事 件 添加 的 扩展 功能 使 其 更 有 意义 ， 代 码 清单 4-56 为 空中 间 抛 出 事件 添加 了 一 个 监听 器 。 


代码 清单 4-56 ”为 空中 间 抛 出 事件 添加 监听 器 


<intermediateThrowEvent id="noneintermediatethroweventl" name="NoneThrowEvent"> 
<extensionElements> 
<activiti:executionListener #1 
class="me.kafeitu.listener.ChangeBusinessState"></activiti:executionListener> #2 
</extensionElements> 
</intermediateThrowEvent> 


代码 清单 4-56 在 #1 处 为 空中 间 抛 出 事件 添加 了 Activiti 的 扩展 功能 activiti:execution-Listener， 让 空中 间 抛 出 事件 更 有 意义 ， 在 #2 处 设置 了 监听 的 class 名 称 。 在 实际 应 用 过 程 中 ， 可 以 在 监听 器 中 书写 


业务 逻辑 ， 当 然 流程 变量 也 是 可 以 获取 的 。 


2. 信 号 中 间 抛 出 事件 


顾名思义 ， 信 号 中 间 抛 出 事件 可 以 抛 出 一 个 信号 ， 然 后 交 给 引擎 传播 信号 事件 。 


言 号 中 间 抛 出 事件 的 图 形 化 表示 是 在 中 间 事 件 的 基础 上 帜 套 一 个 实心 的 三 角 符号 ， 如 图 4-56 所 示 ， 对 应 的 XML 描 述 如 代码 清单 4-57 所 示 。 


代码 清单 4-57 “信号 中 间 抛 出 事件 的 XML 描 述 


<intermediateThrow 


Event id="noneintermedia 


<signall 
</intermediateThrow 


Event De 


finition signalRef="signal 
Event> 


图 4-57 展 示 了 信号 中 间 抛 出 事件 的 一 个 应 用 场景 。 


代码 清单 4-58 列 出 了 图 4-57 对 应 的 XML 描述 。 


代码 清单 4-58 图 4-57 对 应 的 XML 描述 


<signal idq="signal-001" name=" 发 送 通 久 


<process id="Signal] 


[ntermediateThrow 


[信号 "></signal> 
Event" name="Signall] 


#1 


Event De 


[ntermedia 


图 4-56 ”信号 中 间 抛 出 事件 


tethroweventl" name=" SignalThrow. 


-001"></signall finition> 


图 4-57 


Event 


teThrowEvent"> 


SS 


信号 中 间 抛 出 事件 的 一 个 应 用 场景 


<startEvent id="starteventl" name="Start"></startEvent> 

<userTask id="usertaskl" name=" 任 务 一 "></userTask> 

<sequenceFlow id="flowl" name="" sourceRef="starteventl" targetRef="usertask1l"/> 

<intermediateThrowEvent id="siEventl" name="SignalThrowEvent"> 2 
<signalEventDefinition signalRef="signal-001"></signalEventDefinition> #3 

</intermediateThrowEvent> 

<sequenceFlow id="flow2" name="" sourceRef="usertaskl" targetRef=" siEventl1"/> 

<userTask id="usertask2" name=" 任 务 二 "></userTask> 

<sequenceFlow id="flow3" name="" sourceRef=" siEventl" targetRef="usertask2"/> 

<endEvent id="endeventl1l" name="End"></endEvent> 

<sequenceFlow id="flow4" name="" sourceRef="usertask2" targetRef="endevent1"/> 


</process> 


代码 清单 4-58 在 #1 处 首先 定义 了 一 个 信号 “signal-001”， 在 #2 处 定义 了 一 个 信号 中 间 抛 出 事件 ， 紧 接着 在 #3 处 设置 抛 出 的 信号 引用 “signal-001”。 在 “任务 一 ”执行 完成 之 后 直接 抛 出 信号 事件 并 
等 待 匹配 的 信号 捕获 事件 执行 完成 ， 如 果 在 执行 过 程 中 有 有 异常 地 出 ， 那 么 事务 回 滚 ， 否 则 继续 执行 信号 中 间 抛 出 事件 的 输出 流 ， 也 就 是 创建 “任务 二 ”。 


代码 清单 4-58 的 抛 出 是 “同步 ”的 ， 如 果 其 中 一 个 失败 ， 那 么 其 他 的 已 经 执行 过 的 信号 事件 全 部 回 滚 ; 同样 ， 也 可 以 设置 非 同步 即 “ 异 步 ” 执 行 ， 意 思 就 是 引擎 只 会 把 信号 抛 出 而 不 关心 事务 ， 在 
Activiti 中 会 先 创建 和 匹配 到 的 信号 事件 相同 数量 的 作业 (Job， 定 时 执行 ) ， 由 引擎 负责 作业 的 调度 ， 不 会 等 待 其 他 信号 事件 的 执行 结果 而 继续 执行 信号 中 间 抛 出 事件 的 输出 流 。 


代码 清单 4-59 列 出 了 信号 中 间 抛 出 事件 的 异步 方式 的 XML 描述 。 


代码 清单 4-59 ”信号 中 间 抛 出 事件 的 异步 方式 的 XML 描述 


<intermediateThrowEvent id="siEventl" name="SignalThrowEvent"> 
<signalEventDefinition signalRef="signal-001™" activiti:async="true"> 
</signalEventDefinition> 

</intermediateThrowEvent> 


从 代码 清单 4-59 可 以 看 出 ， 比 代码 清单 4-58 的 #3 处 多 了 一 个 Activiti 的 扩展 属性 activiti:async="true"， 这 样 即 可 表示 一 个 异步 的 信号 中 间 抛 出 事件 。 


4.7 ”监听 器 
监听 器 是 Activiti 在 BPMN 2.0 规 范 基础 上 扩展 的 功能 ， 是 业务 与 流程 的 “ 非 侵 入 性 粘 合 剂 ”。 熟 悉 设 计 模 式 的 读者 应 该 能 很 快 联想 到 “观察 者 模式 ”的 一 种 实现 “监听 器 模式 ”， 在 Activiti 中 开发 人 员 
可 以 通过 配置 监听 器 的 方式 监听 各 种 动作 ， 例 如 流程 启动 、 结 束 、 任 务 创建 、 任 务 完成 ， 甚 至 是 经 过 某 个 顺序 流 时 。 


监听 器 分 为 两 类 : 执行 监听 器 和 任务 监听 器 ， 和 其 他 的 Activiti 扩 展 模型 一 样 ， 监 听 器 需要 包含 在 BPMN 2.0 规 范 的 <extensionElements> 标 签 中 。 


4.7.1 执行 监听 器 
执行 监听 器 允许 在 执行 流程 过 程 中 执行 Java 代 和 码 (实现 了 监听 器 接口 ) 或 表达 式 。 
执行 监听 器 可 以 捕获 的 事件 如 下 : 
* 流程 实例 启动 、 结 束 
` 输出 流 捕 获 
: 活动 启动 、 结 来 
“ 路 由 开始 、 结 来 
. 中 间 事 件 开 始 、 结 束 
" 触发 开始 事件 、 触 发 结束 事件 
多 个 事件 的 XML 定义 方式 有 一 个 共同 点 ， 都 是 在 对 应 的 监听 对 象 内 的 extension-Elements 中 添加 activiti:executionListener 扩 展 属 性 。 


4 二 | 入 


执行 监听 器 使 用 Activiti 的 扩展 元 素 <activiti:executionListener> 定 义 ， 通 过 event 属 性 指定 监听 事件 的 类 型 (分 为 三 类 : start、end、take) ， 并 且 可 以 选择 监听 器 执行 类 型 。 表 4-14 列 出 了 执行 监听 
器 的 3 种 监听 器 执行 类 型 。 


表 4-14 ”执行 监听 器 的 3 种 监听 器 执行 类 型 


监听 器 执行 类 型 属性 说 明 及 示例 


需要 实现 接口 : org.activiti.engine.delegate.ExecutionListener 
class <activiti:executionListener event="start" 
class="me.kafeitu.listener.ExecutionListenerForStart" /> 


定义 一 个 表达 式 ， 类 似 EL 的 语法 
<activitl:executionL1stener 
expression expression="$ {pojo.method(execution.eventName)}" event="end" /> 
这 里 的 pojo 是 一 个 Bean 的 名 称 (可 以 用 spring 代理 )， 还 可 以 在 expression 中 通过 计算 
一 个 表达 式 配 置 监听 带 的 名 称 
class 属性 必须 显示 指定 一 个 class 的 全 路 径 ， 如 me.kafeitu.ExecutionListenerXxx。 在 有 
些 情况 下 需要 根据 业务 的 不 同 动态 指定 一 个 接口 实现 ，delegateExpression 允许 指定 一 个 
实现 了 监听 接口 (参考 class 属性 的 限制 ) 类 的 name， 有 具体 的 类 可 以 在 引擎 中 配置 或 由 
delegateExpression | spring 代理 
<activiti:executionListener event="start" 
delegateExpression="$ {executionListenerBean}" /> 
其 中 $fexecutionListenerBean } 为 一 个 Bean 对 象 的 名 称 


全 注意 “这 3 种 监听 器 执行 类 型 只 能 使 用 其 中 的 一 种 。 


监听 输出 流 (包含 经 过 顺序 流 、 条 件 顺 序 流 ) 中 没有 开始 、 结 束 事件 类 型 ， 只 有 在 经 过 输出 流 的 时 候 被 触 上 用， 如 代码 清单 4-60 所 示 。 


代码 清单 4-60 ”监听 输 出 流 的 take 事 件 


<process id="executionListenersProcess"> 
<userTask id="firstTask" /> 
<sequenceFlow sourceRef="firstTask" targetRef="secondTask"> 
<extensionElements> 
< executionListener event="take" #1 
class="me.kafeitu.listener.ExecutionListenerForFlow" /> #2 
</extensionElements> 
</sequenceFlow> 
</process> 


代码 清单 4-60 的 #1 处 在 sequenceFlow 中 定义 了 take 类 型 执行 监听 ， 当 流程 经 过 这 个 顺序 流 的 时 候 将 会 被 触发 ， 也 就 是 执行 #2 处 的 me.kafeitu.listener.ExecutionListener-ForFlow 类 。 
此 外 还 可 以 在 监听 中 使 用 <activiti:field/> 注 入 字段 (参考 4.3.6 节 ) ， 在 流程 运行 时 监听 实现 类 可 以 通过 接口 中 的 对 象 获取 字段 的 值 ， 如 代码 清单 4-61 所 示 。 


代码 清单 4-61 在 执行 监听 器 中 注入 字段 


<process id="executionListenersProcess"> 
<userTask id="firstTask" /> 
<sequenceFlow sourceRef="firstTask" targetRef="secondTask"> 
<extensionElements> 
<activiti:executionListener event="take" 
class="me.kafeitu.listener.ExecutionListenerForFlow" > 
<activiti:field name="firstVar" stringValue="Henry Yan" /> #1 
<activiti:field name="secondVar" expression="${'user' + counter}" /> #2 
</activiti:executionListener> 
</extensionElements> 
</sequenceFlow> 
</process> 


代码 清单 4-61 在 #1 处 使 用 activiti:field 为 监听 器 me.kafeitu.listener.ExecutionListener-ForFlow 注 入 了 和 名称 为 firstVar 的 变量 ， 这 样 在 监听 器 中 就 可 以 通过 调用 Activiti 引 擎 的 方法 获取 变量 的 值 ;， 在 #2 
处 通过 计算 表单 式 'user+counter 的 值 为 变量 secondVar 赋 值 ， 这 样 可 以 根据 业务 的 状态 动态 设置 变量 的 值 。 


4.7.2 ”任务 监听 器 


相对 于 执行 监听 器 的 使 用 范围 来 说， 任务 监听 器 的 使 用 范围 要 小 很 多 ， 因 为 它 只 能 应 用 于 用 户 任务 (4.3.1 节 ) ， 用 来 监听 3 种 事件 。 
: cteate: 在 任务 被 创建 且 所 有 的 任务 属性 设置 完成 之 后 才 触 发 。 


:assignment: 在 任务 被 分 配给 某 个 办 理 人 之 后 触发 。 有 一 点 需要 注意 ，assignment 事 件 总 是 在 cteate 事 件 触 发 之 前 被 触发 ， 因 为 任务 的 办 理 人 是 一 个 属性 ， 而 cteate 事 件 需 要 逐一 处 理 任 务 的 办 理 人 人、 候选 
人 、 人 候选 组 属性 。 


complete: 在 配置 了 监听 器 的 上 一 个 任务 完成 时 触发 ， 也 就 是 在 运行 时 任务 数据 被 删除 之 前 (Activiti 的 数据 分 为 运行 时 和 历史 两 种 类 别 ， 当 运行 时 数据 处 理 完毕 后 将 会 被 清理 ) 触发 。 
表 4-15 列 出 了 任务 监听 器 的 3 种 监听 器 执行 类 型 。 


表 4-15 ”任务 监听 器 的 3 种 监听 器 执行 类 型 


监听 六 执行 类 型 属性 说 明 及 示例 
class 需要 实现 接口 : org.activiti.engine.delegate.TaskListener 


个 表达 式 ， 类 似 EL 的 语法 
a 
expression expression="$ {pojo.method(execution.eventName)}!" event="end" /> 
这 里 | ] pojo 是 一 个 Bean 的 名 称 (可 以 用 spring 代理 )， 还 可 以 在 expression 中 通过 计 
算 一 个 表达 式 配 置 监听 硕 的 名 称 


class 属性 必须 显 示 指 定 一 个 class 的 全 路 径 ， 如 me.kafeitu.TaskListenerOnXxxEvent 
在 有 些 情况 下 需要 根据 业务 的 不 同 动态 指定 ”个 接口 实现 ，delegzteExpression 允许 指 
定 一 个 实现 了 监听 接口 〈 参 考 class 属性 的 限制 ) 类 的 name， 具体 的 类 可 以 在 引擎 中 
配置 或 由 spring 代理 

<activiti:taskListener event="start" delegateExpression="$ {taskListenerBean}" 

其 中 $f taskListenerBean } 为 一 个 Bean 对 象 的 名 称 


delegateExpression 


代码 清单 4-62 列 出 了 请 假 流 程 中 的 “领导 审批 ”节点 完成 时 触发 me.kafeitu.listener.TaskListenerForLeaveOnComplete 监 听 实 现 类 。 


代码 清单 4-62 ”任务 监听 器 的 XML 描述 


<userTask id="leaderAudit" name=" 销 假 " > 
<extensionElements> 
<activiti:taskListener event="complete" 
class="me.kafeitu.listener.TaskListenerForLeaveOnComplete" /> 
</extensionElements> 
</userTask> 


代码 清单 4-62 在 userTask 中 添加 了 activiti:taskListener 元 素来 定义 任务 监听 器 ， 并 且 通 过 属性 event= “complete” 设 置 当 任务 完成 时 触发 ， 从 而 执行 监听 器 类 


me.kafeitu.listener.TaskListenerForLeaveOnComplet。 


任务 监听 器 和 执行 监听 器 一 样 可 通过 添加 <activiti'field/ > 为 任务 监听 器 注入 字段 ， 参 考 代 码 清单 4-61。 


4.8 ”本 章 小 结 

本 章 讲解 了 Activiti 目 前 支持 的 部 分 BPMN 2.0 规 范 ， 是 实战 篇 的 理论 基础 。 本 章 旨 在 从 理论 上 使 读者 对 BPMN 2.0 规 范 及 Activiti 对 其 扩展 上 有 一 个 全 面 的 认识 ， 了 解 BPMN 2.0 规 范 能 做 什么 ，Activiti 
又 在 其 基础 上 封装 和 扩展 了 什么 。 

本 章 每 一 节 都 是 从 概念 开始 引导 ， 然 后 展示 活动 的 基本 XML 描 述 ， 最 后 利用 日 常用 例 讲解 各 个 规范 的 实际 用 途 。 


在 下 一 部 分 一 一 实战 篇 中 将 会 以 OA 系统 为 例 讲解 如 何 使 用 Activiti 作 为 工作 流 引 擎 开发 OA 系统 的 业务 模块 。 当 读者 对 于 实战 篇 中 的 例子 迷惑 的 时 候 ， 不 妨 再 回顾 一 下 规范 对 其 是 如 何 定义 的 。 


经 过 了 准备 篇 和 基础 篇 的 学 习 ， 大 家 了 解 了 Activiti 的 大 体 架 构 ， 学 会 了 如 何 运 行 一 个 Hello Wotd 程 序 ， 并 且 从 概念 和 基础 的 XML 定义 上 了 解 了 BPMN 2.0 规 范 及 Activiti 对 其 进行 的 一 些 扩 展 功 能 。 


本 篇 在 前 面 两 篇 内 容 的 基础 上 正式 进入 Activiti 的 实战 阶段 ， 本 篇 的 每 个 章节 都 会 在 日 常 流程 基础 上 进行 讲解 ， 这 样 比较 容易 从 业务 层 理解 ， 也 有 利于 学 会 如 何 应 用 Activiti 的 各 种 功能 。 本 篇 主要 以 大 多 
数 公司 或 者 政府 单位 使 用 的 OA 系统 为 基础 ， 一 步 一 步 讲解 如 何 用 Activiti 进 行 构建 。 


在 TDD 盛 行 的 今天 我 们 当然 也 不 能 落下 前 进 的 脚步 TDD 的 好 处 一 大 堆 ， 有 兴趣 的 读者 可 以 参考 相关 书籍 深入 学 习 。 本 书 大 部 分 代码 的 展示 会 以 单元 测试 为 主 ， 这 样 既 可 保证 代码 的 可 执行 性 ， 又 有 利 
于 读者 对 整个 过 程 的 理解 。 对 于 没有 接触 过 ITDD 的 读者 也 不 用 太 查 心 ， 在 实例 代码 中 可 以 一 步 一 步 解释 其 含义 。 


第 5 章 ”用 户 与 组 及 部 署 管 理 
把 本 章 作为 实战 部 分 的 第 一 章 是 因为 用 户 和 流程 部 署 的 管理 是 一 把 金 铀 匙 。 在 工作 流 中 最 重要 的 参与 者 是 人 ， 流 程 中 定义 了 何 时 需要 人 参与 、 何 时 由 系统 处 理 ， 所 以 在 开始 实例 之 前 首先 要 学 会 管理 这 
些 基础 数据 以 及 它们 之 间 的 关系 。 


首先 讲解 Activiti 中 内 置 的 一 套用 户 、 组 的 关系 ， 以 及 如 何 通 过 API 添 加 、 删 除 、 查 询 ; 然后 就 是 流程 定义 的 管理 ， 包 括 部 署 、 删 除 、 读 取 部 署 的 资源 文件 ， 还 有 中 国 用 户 比较 关注 的 流程 图 中 文 乱码 问 
题 的 解决 办 法 。 


通过 本 章 内 容 读者 将 学 会 如 何 通 过 调用 Activiti 的 APl 来 管理 用 户 以 及 流程 定义 。 


登 说明 本 书 的 示例 代码 均 使 用 Maven 构 建 ， 对 于 一 些 配置 读者 可 参考 bpmn20-example 项 目 中 的 pom.xml 文 件 ， 其 中 用 中 文 详细 说 明了 各 个 配置 的 作用 。 


5.1 ”用户 与 组 


Activiti 中 内 置 了 一 套 相 对 简单 的 对 用 户 和 组 的 支持 ， 可 以 满足 基本 业务 需求 对 用 户 和 组 的 要 求 。 其 中 ， 组 也 可 以 理解 为 我 们 常 说 的 角色 ， 和 用 户 的 关系 是 多 对 多 。 相 信 这 个 关系 读者 应 该 不 陌生 了 ， 可 
以 回顾 一 下 自己 公司 或 项 目 中 的 用 户 组 织 权限 的 结构 。 


在 学 习 过 程 中 除了 使 用 单元 测试 来 帮助 理解 之 外 ， 读 者 还 可 以 结合 2.5 节 中 的 Activiti Explorer 实 际 操作 来 加 深 理解 。 
5.1.1 用 户 


在 各 种 需要 人 工 参 与 的 系统 中 ， 用 户 和 组 是 一 个 身份 系统 (或 者 模块 ) 的 基础 ， 在 Activiti 中 用 户 和 组 主要 是 应 用 于 用 户 任 务 (userTask， 见 4.3.1 节 ) 。 
代码 清单 5-1 利 用 单元 测试 说 明 操 作 Activiti 中 用 户 管理 功能 的 各 个 API 的 使 用 。 


代码 清单 5-1 用 户 管理 的 API 演 示 


public class IdentifyServiceTest { 
@Rule 
// 使 用 默认 的 activiti.cfg.xml 作 为 参数 
public ActivitiRule activitiRule = new ActivitiRule(); #1 
// 用 户 管理 的 API 演 示 
@Test 


public void testUser() throws Exception { 


// 获取 IdentifyService 实 例 

IdentityService identityService = activitiRule.getIidentityService (); #2 
// 创建 一 个 用 户 对 象 

User user = identityService.newUser ("henryyan".); #3-S 


user.setFirstName ("Henry"); 
user.setLastName ("Yan") ， 


user.setEmail ("yanhonglei@gmail .com"); #3--E 
// 保存 用 户 到 数据 库 
identityService.saveUser (user); #4 
// 验证 用 户 是 否 保存 成 功 
User userIinDb = identityService.createUserQuery () #5-S 


.userId ("henryyan") .singleResult (); #5-E 
assertNotNull (userInDb); 


// 删除 用 户 

identityService.deleteUser ("henryyan"); #6 

// 验证 是 否 删 除 成 功 

userInDb = identityService.createUserQuery() .userId("henryyan") .singleResult ();} #7-S 
assertNull (userInDb); #7 一 EE 


从 代码 清单 5-1 中 可 以 看 出 ， 这 是 一 个 日 常 开发 经 常 接触 的 CRUD 操 作 ， 使 用 方式 都 比较 简单 ， 而 且 支 持 链 式 操作 ， 读 者 可 以 在 解压 activiti-version.zip 后 在 docs/javadoc 中 找到 API 文 档 ， 在 1.3 节 
的 “引擎 API” 中 提 到 的 7 个 Service 接 口 都 位 于 org.activitengine 包 中 。 


下 面 一 一 讲解 每 一 行 代码 的 作用 。 


#1 处 的 作用 是 创建 一 个 测试 的 Rule 对 象 ， 并 且 使 用 指定 的 “activiti.cfg.xml” 作为 配置 文件 ; 当 创 建 ActivitiRule 对 象 时 会 自动 创建 一 个 引擎 对 象 ProcessEngine， 这 样 就 可 以 通过 activitiRule 实 例 获 取 
7 个 service 及 其 他 对 象 了 。 此 处 也 可 以 不 指定 “activiti.cfg.xml” 参 数 ， 即 通过 new ActivitiRule() 一 样 可 以 创建 一 个 基于 内 人 存 数 据 库 (H2) 的 引擎 实例 ， 这 是 因为 ActivitiRule 默 认 使 用 名 称 
为 “activiti.cfg.xml” 的 配置 文件 ， 读 者 可 以 修改 代码 进行 验证 。 


#2 处 就 比较 简单 了 ， Ce 细心 的 读者 可 能 发 现 这 里 获取 实例 的 方法 与 第 2 章 中 的 方式 不 同 ， 但 是 结果 是 一 样 的 ， 因 为 Activiti 提 供 了 多 种 不 同 的 方 
式 来 获取 各 个 Service 实 例 。 在 第 7 章 中 还 会 介绍 通过 Spring 注入 Service 实 例 的 方式 。 


#3 处 用 于 创建 一 个 ID 为 “henryyan” 的 User 对 象 ， 但 是 并 不 会 立即 保存 到 数据 库 ， 而 是 创建 一 个 临时 对 象 ， 紧 接着 设置 了 用 户 的 其 他 属性 。 


#4 处 保存 一 个 User 对 象 ， 只 有 调用 了 saveUser 才 会 把 创建 或 更 改 的 最 新 属性 持久 化 到 数据 库 。 


#5 处 用 于 查询 数据 库 中 的 用 户 数据 ， 首 先 需要 创建 一 个 用 户 查询 对 象 即 调用 “identityService.createUserQuery0” 方法， 接着 使 用 “ 链 式 [1]” 编程 方式 设置 用 户 的 ID 属性 等 于 “henryyan″ ， 最 后 调 
用 list( 方 法 返回 一 个 对 象 集合 。 当 然 除了 获取 一 个 对 象 集合 外 ， 还 可 以 只 获取 单个 对 象 ， 把 list0 换 成 sngleResult0 即 可 ， 当 然 对 应 的 返回 类 型 就 不 能 为 List 了 ， 而 是 User。 


#6 处 通过 指定 一 个 User 的 ID 属性 值 删除 一 个 User 对 象 。 


#7 处 和 #5 处 相当 于 验证 组 的 数量 是 否 和 期 望 一 致 ， 在 #6 处 已 经 删除 了 User 对 象 ， 所 以 这 里 查询 的 用 户 对 象 为 空 。 
5.1.2 组 


组 是 控制 权限 的 一 种 方式 ， 属 于 某 个 组 的 用 户 就 拥有 操作 某 些 功能 的 权限 。 本 节 详 细 说 明 Activiti 内 置 的 组 管理 及 API 的 使 用 。 
在 Activiti 中 ， 组 的 类 型 分 为 两 种 ， 即 assignment 和 security-role， 前 者 为 一 种 普通 的 岗位 角色 ， 是 用 户 分 配 业 务 中 的 功能 权限 ， 后 者 是 安全 角色 ， 可 以 从 全 局 管理 用 户 组 织 及 整个 流程 的 状态 。 
代码 清单 5-2 利 用 单元 测试 讲解 操作 Activiti 中 组 管理 功能 的 各 个 API 的 使 用 。 


代码 清单 5-2 ”组 管理 的 API 演 示 


public class IdentityService Test { 

QRule 

public ActivitiRule activitiRule = new ActivitiRule ("activiti.cfg.xml"); 

// 组 管理 的 API 演 示 

QTest 

public void testGroup() throws Exception { 
// 获取 IdentifyService 实 例 


IdentityService identityService = activitiRule.getIdentityService(); 
// 创建 一 个 组 对 象 
Group group = identityService.newGroup ("deptLeader"); 
group .setName (" 部 门 领导 ") ， 
group.setType ("assignment"); 
// 保存 组 
a 

// 验证 组 是 否 已 保存 成 功 ， 首 先 需 要 创建 组 查询 对 象 
List<Group> groupList = identityService.createGroupQuery() .grouplId ("deptLeader") .List()， 
assertEquals (1, groupList.size()); 
// 删除 组 
identityService.deleteGroup ("deptLeader"); 
// 验证 是 否 删除 成 功 
groupList = identityService.createGroupQuery() .groupId ("deptLeader") .List()， 
assertEquals (0, groupList.size()); 


代码 清单 5-2 和 代码 清单 5-1 类 似 ， 只 不 过 把 用 户 换 成 了 组 ， 所 以 不 再 一 一 介绍 每 一 步 的 功能 ， 读 者 可 以 查看 bpmn20-example 中 的 IdentityServiceTest 类 运行 单元 测试 的 验证 结果 。 


5.1.3 用户 与 组 的 关系 


在 5.2.1 和 5.2.2 节 中 分 别 介绍 了 如 何 使 用 Activiti 的 API 操 作用 户 和 组 。 如 果 仅 仅 只 有 用 户 和 组 ， 那 只 能 说 是 一 堆 散 沙 ， 本 节 将 介绍 如 何 让 这 两 者 建立 起 对 象 关联 关系 。 
代码 清单 5-3 演 示 了 如 何 创建 用 户 与 组 的 关系 ， 以 及 如 何 根据 用 户 或 组 查询 关联 的 另外 一 方 。 


代码 清单 5-3 ”设置 用 户 与 组 的 关系 


public class IdentifyServiceTest { 
@Rule 
public ActivitiRule activitiRule = new ActivitiRule ("activiti.cfg.xml"); 
// 组 和 用 户 关 联 关 系 API 演 示 
GTest 
public voidq testUserAndGroupMemership() throws Exception { 
// 创建 并 保存 组 对 象 
Group group = identityService.newGroup ("deptLeader"); #1-S 
group.setName (" 部 门 领导 ") ， 
group.setType ("assignment") ， 
identityService.saveGroup (group); #1-E 
// 创建 并 保存 用 户 对 象 
User user = identityService.newUser ("henryyan".); #2-S 
user.setFirstName ("Henry"); 
user.setLastName ("Yan"); 
user. setEmail ("yanhonglei@gmail .com"); 
identityService.saveUser (user); #2-E 
// 把 用 户 henryyan 加 入 到 组 dqeptLeader 中 
identityService.createMembership ("henryyan", "deptLeader"); #3 
// 查询 属于 组 deptLeader 的 用 户 


User userInGroup = #4-S 
| 


identityService.createUserQuery () .memberOfGroup ("deptLeader") .singleResult () ， 
assertNotNull (userInGroup); 

assertEquals ("henryyan", userlinGroup.getId()); #4-E 
// 查询 henryyan 所 属 组 

Group groupContainsHenryyan 加 #5-S 
identityService.createGroupQuery () .groupMember ("henryyan") .singleResult () ; 
assertNotNull (groupContainsHenryyan); 

assertEquals ("deptLeader", groupContainsHenryyan.get1Id()); #5-E 


在 代码 清单 5-3 中 ， 首 先 创建 组 、 用 户 ， 然 后 设置 两 者 的 关系 ， 最 后 以 不 同 的 方式 查询 关联 的 对 方 。 
#1 处 的 作用 在 5.1.2 已 经 介绍 了 ， 用 来 创建 并 保存 一 个 组 对 象 。 
#2 处 的 作用 也 在 5.1.1 绍 了 ， 用 来 创建 并 保存 一 个 用 户 对 象 。 


#3 处 是 本 例 的 关键 代码 ， 通 过 调用 方法 createMembership(“henryyan”，“deptLeader”) 把 用 户 “henryyan” 加 入 到 组 “deptLeader” 中 。 


堆 处 用 memberOfGroup() 方 法 查询 属于 组 “deptLeader” 的 用 户 ， 此 处 只 保存 了 一 个 用 户 ， 所 以 用 sigleResult( 方 法 返回 一 个 用 户 实例 ， 如 果 保 存 了 多 个 用 户 ， 就 需要 使 用 list( 方 法 代替。 


#5 处 和 #4 相 反 ， 用 groupMember() 方 法 从 组 的 这 一 方 查 询 包 含 的 用 户 


5.1.4 用 户 任务 中 的 用 户 与 组 


有 了 用 户 、 组 ， 以 及 两 者 之 间 关 系 的 基础 ， 再 来 看 看 如 何在 实际 应 用 中 使 用 它们 ， 这 里 通过 一 个 只 有 一 个 用 户 任务 节点 的 简单 流程 进行 演示 。 


1. 候 选 组 


首先 来 看 一 下 这 个 例子 的 流程 图 ， 如 图 5-1 所 示 。 


在 学 习 本 节 的 示例 之 前 先 回顾 一 下 2.4.4 节 中 提 到 的 “签收 ” (代码 清单 2-5) ， 当 不 确定 要 将 一 个 任务 分 配给 哪个 人 办 理 时 ， 就 需要 把 任务 指定 给 多 个 候选 人 或 候选 组 。 本 节 的 示例 是 把 任务 分 配给 一 
个 候选 组 “deptLeader”， 意 思 就 是 属于 这 个 组 的 用 户 都 可 以 是 “潜在 ”的 办 理 人 ， 但 是 大 家 都 遵守 一 个 规则 : 谁 “签收 ”了 这 个 任务 谁 就 可 以 办 理 任 务 。 


[La 


学 习 用 户 与 组 在 用 户 
任务 的 应 用 


图 5-1 学 习 用 户 与 组 在 用 户 任 务 中 的 应 用 流程 图 


首先 浏览 一 下 图 5-1 对 应 的 XML 代码 ， 如 代码 清单 5-4 所 示 。 


代码 清单 5-4 图 5-1 对 应 的 XML 


<process id="userAndGroupInUserTask" name="userAndGroupInUserTask"> #1 
<startEvent id="starteventl" name="Start"></startEvent> 
<userTask id="studyUserAndGroupInUserTask" #2 
name=" 学 习 用 户 与 组 在 用 户 任务 中 的 应 用 " 
activiti:candidateGroups="deptLeader"></userTask> #3 
<sequenceFlow id="flowl" name="" sourceRef="starteventl1" 
targetRef="studyUserAndGroupInUserTask"></sequenceFlow> 
<endEvent id="endeventl1l" name="End"></endEvent> 
<sequenceFlow id="flow2" name="" sourceRef="studyUserAndGroupInUserTask" 
targetRef="endevent1"></sequenceFlow> 


</process> 


代码 清单 5-4 的 #1 处 定义 了 一 个 ID 为 “userAndGrouplnUserTask” 的 流程 定义 。 

#2 处 定义 了 一 个 用 户 任务 ， 对 应 图 5-1 中 的 “学 习 用 户 与 组 在 用 户 任务 中 的 应 用 ”部 分 。 

#3 处 用 4.3.1 节 介绍 过 的 activiti:candidateGroups 属 性 定义 用 户 任务 的 候选 组 为 “deptLeader”。 

了 解 了 这 个 流程 定义 的 内 容 后 ， 接 着 通过 测试 代码 驱动 方式 学 习 用 户 、 组 及 它们 之 间 的 关系 如 何在 用 户 任务 中 应 用 。 

有 了 5.1.1、5.1.2、5.1.3 小 节 的 基础 之 后 我 们 对 新 的 单元 测试 稍微 调整 ， 把 添加 用 户 、 组 及 建立 关系 的 代码 抽取 成 一 个 方法 ， 见 代码 清单 5-5。 


代码 清单 5-5 单元 测试 中 封装 了 用 户 、 组 的 初始 化 及 清理 方法 


public class UserAndGroupInUserTaskTest extends AbstractTest { 
QBefore 
public void setUp() throws Exception { 
// 初始 化 7 个 Service 实 例 
Super .SetUp () ， 
// 创建 并 保存 组 对 象 
Group group = identityService.newGroup ("deptLeader"); 
group .setName (" 部 门 领导 ") ， 
group.setType ("assignment"); 
identityService.saveGroup (group); 
// 创建 并 保存 用 户 对 象 
User user = identityService.newUser ("henryyan".); 
user.setFirstName ("Henry"); 
user.setLastName ("Yan™"); 
user.setEmail ("yanhongleiQgmail .com"); 
identityService.saveUser (user); 
// 把 用 户 henryyan 加 入 到 组 dqeptLeader 中 
identityService.createMembership ("henryyan", "deptLeader"); 


} 

@After ”// 每 个 方法 执行 完 后 清理 用 户 与 组 

public void afterIinvokeTestMethod() throws Exception { 
identityService.deleteMembership ("henryyan", "deptLeader"); 
identityService.deleteGroup ("deptLeader"); 
identityService.deleteUser ("henryyan"); 

} 

} 


这 里 针对 不 太 了 解 JUnit 的 读者 稍微 做 一 下 介绍 ， 在 方法 setUp() 上 注解 @Before 的 作用 : 当 测 试 (有 @Test 注 解 的 方法 ) 方法 开始 执行 之 前 会 被 调用 一 次 ; 相反 在 afterlnvoke-TestMethod() 方 法 上 
@Aftet 注 解 的 作用 : 当 一 个 测试 方法 执行 结束 之 后 执行 一 次 。 


本 示例 的 作用 就 是 在 每 个 方法 执行 之 前 添加 用 户 、 组 并 建立 关系， 每 个 测试 方法 执行 结束 之 后 再 清理 添加 的 数据 。 
基于 前 面 的 介绍 来 分 析 一 段 有 关 用 户 任务 中 候选 组 的 代码 片段 ， 见 代码 清单 5-6。 


代码 清单 5-6 ”用户 任务 中 的 候选 组 


QTest 


QDeployment (resources = { "chapter5/userAndGroupInUserTask.bpmn" }) 
public void testUserAndGroupInUserTask() throws Exception 1{ 
// 启动 流程 
Processinstance ProcessInstance = 
runtimeService.startProcessInstanceByKey ("userAndGroupInUserTask"); #1 

assertNotNull (processInstance); 

24 根据 角色 查询 任务 

Task task = taskService.createTaskQuery() .taskCandidateUser ("henryyan") .singleResult (); 井 2 
taskService.claim(task.getId(), "henryyan"); #3 
taskService.complete (task.getId()); #4 


代码 清单 5-6 的 目的 就 是 读 取 用 户 “henryyan” 的 候选 任务 ， 下 面 一 一 分 析 。 
#1 处 大 家 已 经 很 熟悉 了 ， 根 据 流程 定义 的 ID 启动 一 个 流程 实例 。 
#2 处 用 于 查询 用 户 任务 ， 并 且 通 过 条 件 taskCandidateUser("henryyan ") 过 滤 包 含 候选 人 “henryyan” 的 用 户 任务 。 


解释 一 下 “候选 人 ”的 含义 ， 回 顾 4.3.1 节 对 用 户 任务 的 介绍 ， 其 中 提 及 两 个 属性 : activiti:cadidateUsers 和 activiti:cadidateGroups。 如 果 在 属性 activiti:cadidateUsers 中 设置 多 个 用 户 ， 那 么 这 些 用 
户 都 属于 “候选 人 ”; activiti:cadidateGroups 是 定义 候选 组 。 候 选 人 与 候选 组 的 不 同 在 于 后 者 可 以 包含 前 者 ， 所 有 属于 修 选 组 中 的 用 户 都 可 以 理解 为 “候选 人 ”。 通过 图 5-2 更 好 地 了 解 两 者 之 间 的 关 
系 。 


虽然 是 同 级 ， 部 门 领 导 组 
看 谁 先 抢 到 


任务 …… 


我 们 属于 部 
门 领 导 组 


图 5-2 ”描述 “候选 人 ”概念 的 图 形 方 式 


代码 清单 -6 用 示例 说 明了 用 户 、 组 在 用 户 任务 中 的 使 用 ， 并 且 通 过 图 5-2 直 观 地 说 明了 候选 人 的 含义 。 在 此 基础 上 再 来 看 看 如 果 一 个 组 包含 多 个 人 在 用 户 任务 中 该 如 何 处 理 ， 对 应 的 JUnit 单 元 测试 代码 
见 代码 清单 5-7。 


代码 清单 5-7 ”用户 组 中 包含 多 个 用 户 时 在 用 户 任务 中 的 应 用 


@Test 
QDeployment (resources = { "chapter5/userAndGroupInUserTask.bpmn" }) 
public void testUserTaskWithGroupContainsTwoUser() throws Exception { 

// 在 setUp () 的 基础 上 再 添加 一 个 用 户 ， 然 后 加 入 到 组 deptLeader 中 

User user = identityService.newUser ("jackchen"); #1-S 

user.setFirstName ("Jack"); 

user.setLastName ("Chen™");} 

user.setEmail ("jackchen@gmail .com"); 

identityService.saveUser (user); 

// 把 用 户 henryyan 加 入 到 组 deptLeader 中 

identityService.createMembership ("jackchen", "deptLeader"); #1-E 

// 启动 流程 

Processinstance ProcessInstance = 

runtimeService.startProcessInstanceByKey ("userAndGroupInUserTask"); 
assertNotNull (processInstance); 


// jackchen 作 为 候选 人 的 任务 


Task jackchenTask = taskService.createTaskQuery () #2-S 
.taskCandidateUser ("jackchen") .singleResult 1() ， 
assertNotNull (jackchenTask); #2 一 E 
// henryyan 作 为 候选 人 的 任务 
Task henryyanTask = taskService.createTaskQuery () #3-S 
.taskCandidateUser ("henryyan") .singleResult () ， 
assertNotNull (henryyanTask); #3 一 E 
// jackchen 签 收 任务 
taskService. alm a en a getId(), "jackchen"); 大 4 
// 再 次 查询 用 户 henryyan 是 否 拥有 刚刚 的 候选 任务 
henryyanTask = taskService.createTaskQuery () #5-S 


.taskCandidateUser ("henryyan") .singleResult () ， 
assertNull (henryyanTask); #5-E 


代码 清单 5-7 展 示 了 用 户 组 中 包含 多 个 用 户 时 在 用 户 任 务 中 的 应 用 。 本 示例 想 要 说 明 的 是 : 在 一 个 用 户 任务 被 其 中 一 个 候选 人 签收 之 后 ， 其 他 候选 人 同时 失去 拥有 这 个 任务 的 权限 。 下 面 结合 代 码 说 明 每 
个 功能 点 的 含义 。 


#1 处 是 在 setUp() 方 法 基础 上 再 添加 一 个 用 户 “jackchen” 到 组 “deptLeader”， 此 时 组 deptLeader 就 有 两 个 用 户 ， 通 过 图 5-2 的 解释 可 知 ， 这 两 个 用 户 都 属于 任务 “studyUser- 
AndGrouplnUserTask” 的 候选 人 。 


#2 处 验证 用 户 “jackchen” 作 为 候选 人 查询 到 一 个 任务 。 
#3 处 验证 用 户 “henryyan” 作 为 候选 人 查询 到 一 个 任务 。 
#4 人 处 用 户 “jackchen” 签 收 任务 “studyUserAndGrouplnUserTask”， 此 时 任务 属于 “jackchen”， 其 他 候选 人 失去 拥有 这 个 任务 的 权限 。 


#5 处 再 次 查询 用 户 “henryyan” 作为 候选 人 的 任务 ， 查 询 结果 应 该 为 空 ， 因 为 任务 “studyUserAndGrouplnUserTask” 已 经 被 用 户 “jackchen” 签收 ， 所 以 #5-E 处 的 代码 执行 结果 为 true。 


2. 候 选 人 


在 代码 清单 5-6 和 代码 清单 5-7 中 都 把 一 个 组 作为 用 户 任务 的 候选 组 (包含 多 个 候选 人 组 的 名 称 ) ， 如 果 多 个 候选 人 不 属于 任何 候选 组 ， 那 么 是 否 可 以 把 用 户 任务 直接 分 配给 多 个 候选 人 呢 ? 答案 当然 是 


肯定 的 ， 继 续 通过 一 个 例子 来 讲解 把 多 个 用 户 直 接 作为 用 户 任务 的 候选 人 


首先 浏览 一 下 代码 清单 5-8 的 流程 定义 文件 。 


代码 清单 5-8 用户 任务 中 包含 多 个 直接 候选 人 


<process id="candidateUserIinUserTask" name="candqidqateUserInUSeTrITaSK"> 
<startEvent id="starteventl" name="Start"></startEvent> 


<userTask id="usertaskl" name=" 用 户 任务 包含 多 个 直接 候选 人 " 
activiti:candidateUsers="jackchen, henryyan"></userTask> #1 
<sequenceFlow id="flowl" sourceRef="starteventl" targetRef="usertaskl"/> 
<endEvent id="endeventl1l" name="End"></endEvent> 
<sequenceFlow id="flow2" sourceRef="usertaskl" targetRef="endevent1"/> 
</process> 


代码 清单 5-8 和 代码 清单 5-4 基 本 一 致 ， 唯 一 不 同 的 是 : 在 代码 清单 5-8 的 #1 处 把 原来 的 “activiti:candidateGroups” 换 成 了 “activitiicandidateUsers”， 并 且 设 置 其 值 为 “jackchen,， henryyan” ， 


表示 此 任务 有 两 个 候选 人 。 根 据 对 本 节 其 他 例子 的 理解 可 以 判定 : 在 其 中 一 个 用 户 “ 签 收 ” 了 任务 之 后 其 他 的 候选 人 就 失效 了 。 如 果 不 理解 属性 activiti:candidateUsers， 可 以 回顾 一 下 4.3.1 节 表 4-3 中 的 解 


代码 清单 5-9 将 验证 我 们 对 用 户 任务 中 候选 人 的 期 望 


代码 清单 5-9 ”在 测试 用 户 任务 中 直接 设置 多 个 候选 人 


public class CandidateUserInUserTaskTest extends AbstractTest { 
@Test 
QDeployment (resources = { "chapter5/candidateUserInUserTask.bpmn" }) 
public void testMultiCadiateUserIinUserTask() throws Exception { 
// 添加 用 户 jackchen 
User userJackChen = identityService.newUser ("jackchen"); 


identityService.saveUser (userJackChen) 
// 添加 用 户 henryyan 
User userHenryyan = identityService.newUser ("henryyan".); 


~. 


identityService.saveUser (userHenryyan) 
// 启动 流程 
Processinstance ProcessInstance = 
runtimeService.startProcessIinstanceByKey ("candidateUserIinUserTask"); 
assertNotNull (processInstance); 
// jackchen 作 为 候选 人 的 任务 
Task jackchenTask = taskService.createTaskQuery () #1-S 
.taskCandidateUser ("jackchen") .singleResult () ， 
assertNotNull (jackchenTask); #1 一 EE 
// henryyan 作 为 候选 人 的 任务 
Task henryyanTask = taskService.createTaskQuery () #2-S 
.taskCandidateUser ("henryyan") .singleResult () ， #2 一 E 
EN en en 
// jackchen 签 收 任务 
taskService.claim(jackchenTask.getId(), "jackchen"); #3 
// 再 次 查询 用 户 henryyan 是 否 拥有 内 二 从 务 
henryyanTask = taskService.createTaskQuery () #4-S 
.taskCandidateUser ("henryyan") .singleResult () ; 


assertNull (henryyanTask); #4-E 


~. 


C= 


正如 我 们 期 待 的 那样 ， 代 码 清单 5-9 的 执行 结果 是 正确 的 ， 一 切 和 我 们 设想 的 一 样 (单元 测试 真 不 愧 是 学 习 的 利器 ， 可 以 反复 验证 期 望 的 结果 直到 结果 为 绿色 ) 。 
代码 清单 5-9 中 的 #1、#2、#3、#4 和 代码 清单 5-7 中 的 这 几 处 完全 一 样 ， 而 且 执 行 结果 也 是 一 样 ， 这 也 再 次 证 明了 图 5-2 的 说 明 。 
关于 用 户 、 组 及 其 在 用 户 任 务 中 的 应 用 的 介绍 暂时 告 一 段落 ， 在 稍 后 的 章节 还 会 通过 更 多 的 示例 讲解 更 深层 次 的 应 用 。 


1] 链 式 编程 的 表现 形式 为 多 个 方法 以 “.” 分 割 : 在 调用 并 执行 完 一 个 方法 之 后 该 方法 返回 当前 方法 的 对 象 实例 ， 这 样 可 以 继续 调用 返回 对 象 实例 的 其 他 方法 。 链 式 编程 可 以 减少 临时 变量 的 产生 ， 并 且 可 以 


让 代码 更 加 优雅 ， 所 以 在 各 种 框架 和 组 件 中 经 常 被 使 用 。 在 Activiti 中 所 有 的 Query 结 尾 的 类 都 支持 链 式 编程 。 


5.2 部署 流程 资源 
流程 资源 可 以 是 各 种 类 型 的 文件 ， 在 启动 流程 或 流程 实例 运行 过 程 中 会 被 读 取 。 下 面 介 绍 常用 的 流程 资源 。 
. 流程 定义 文件 : 扩展 名 为 ppmn20.xml 和 bpmn; 
流程 定义 的 图 片 : 用 BPMN 2.0 规 范 的 各 种 图 形 描绘 ， 一 般 用 PNG 格 式 ; 
. 表单 文件 : 把 表单 内 容 保存 在 一 个 文件 中 ， 扩 展 名 为 form ; 
. 规则 文件 : 例如 Drools 的 规则 文件 ， 其 扩展 名 为 drl。 


使 用 流程 引擎 的 目的 是 为 了 使 用 流程 驱动 业务 的 流转 。 要 用 流程 驱动 业务 就 必须 为 业务 启动 一 个 流程 实例 ， 启 动 一 个 流程 实例 必须 定义 一 系列 活动 ， 这 一 系列 的 活动 就 组 成 了 一 个 流程 定义 。 在 之 前 的 


多 个 流程 相关 的 例子 中 ， 总 是 先 部 署 一 个 流程 定义 才能 根据 已 部 署 的 流程 定义 启动 流程 实例 ， 但 是 仅仅 使 用 了 一 种 部 署 流程 定义 的 方式 。 本 节 将 详细 讲解 其 他 的 部 署 方式 及 如 何 读 取 部 署 的 资源 文件 。 


部 署 流程 资源 有 很 多 种 方法 ， 包 括 : classpath、InputStream、 字 符 串 、zip 格 式 压 缩 包 。 之 前 的 例子 只 涉及 通过 classpath 方 式 部 署 流程 定义 ， 下 面 一 一 讲解 各 个 部 署 方式 。 


虽然 部 署 方 式 不 同 ， 但 是 均 通 过 RepositoryService 的 createDeployment() 方 法 在 创建 DeploymentBuilder 对 象 后 调用 不 同 的 方法 部 署 资源 。 


在 本 节 的 最 后 用 图 形 方 式 展示 了 部 署 的 过 程 ， 作 为 参考 帮助 读者 理解 下 面 的 代码 。 
5.2.1 classpath 方 式 


classpath 方 式 ， 顾 名 思 义 就 是 要 以 class 目 录 为 基础 寻找 对 应 的 资源 再 部 署 ， 例 如 2.4 节 的 Hello World。 本 章 的 代码 清单 5-6 其 实 也 是 通过 classpath 方 式 部 署 流程 定义 文件 的 ， 只 不 过 Activiti 提 供 了 CDI 
方式 简化 了 部 署 ， 以 便 读 者 把 注意 力 集中 在 测试 代码 。 


classpath 方 式 的 路 径 名 规 学 是 用 斜 枉 “/” 方 式 分 割 多 个 包 名 。 图 5-3 展 示 了 一 个 流程 定义 文件 的 路 径 。 


图 5-3 对 应 的 classpath 为 chapter5/candidateUserlnUser-Task.bpmn。 


T 辆 classes 
T Dl chapters 
candidatelJserinLser lask.Dbpmn 
candidateUserinUser lask.png 


chapter5-deployment.bar 
UserAndGrouplnUserliask.bpmn 
UserAndeGrouplnUserTask.png 
USerAnderouplnUserTask11.bprmn 


图 5-3 class 目录 中 的 流程 定义 文件 目录 结构 
代码 清单 5-10 没 有 使 用 链 式 编程 方式 ， 而 是 列 出 了 部 署 流程 定义 需要 执行 的 几 步 。 


代码 清单 5-10 ”用 classpath 方 式 部 署 流程 定义 文件 


public class ClasspathDeploymentTest extends AbstractTest 1{ 
@Test 
public void testClasspathDeployment () throws Exception { 


// 定义 classpath 
String bpmnClasspath = "chapter5/candidateUserInUserTask.bpmn"; 


String pngClasspath = "chapter5/candidateUserInUserTask.png"; 
// 创建 部 署 构建 器 
DeploymentBuilder deploymentBuilder = repositoryService.createDeployment (); #1 
// 添加 资源 
deploymentBuilder.addClasspathResource (bpmnClasspath); #2-5S 
deploymentBuilder.addClasspathResource (pngClasspath); #2-E 
// 执行 部 署 
deploymentBuilgder.deploy(); #3 
// 验证 是 否 部 署 成 功 
ProcessDefinitionQuery processDefinitionQuery = #4-S 
repositoryService.createProcessDefinitionQuery () ， 
long count = processDefinitionQuery.processDefinitionKey ("candidateUserInUserTask") 
.Count (); 
assertEquals (1, count); #4-E 


// 读 取 图 片 文件 


ProcessDefinition processDefinition = processDefinitionQuery.singleResult () ， #5-S 
String diagramResourceName = processDefinition.getDiagramResourceName () ; #5-1 
assertEquals (pngClasspath, diagramResourceName); #5 一 EE 


代码 清单 5-10 是 一 个 典型 的 classpath 方 式 部 署 流程 定义 的 方法 ， 下 面 拆 分 了 每 一 步 的 动作 进行 说 明 。 

#1 处 创建 一 个 部 署 构 建 器 ， 它 是 部 署 的 入 口 。 

#2 处 添加 了 classpath 资 源 ， 包 括 XML 格 式 的 bpmn 文 件 和 PNG 格 式 的 图 片 文件 ;该 方法 会 立即 读 取 classpath 资 源 文件 为 一 个 输入 流 对 象 。 

#3 处 调用 deploy() 方 法 执行 部 署 ， 此 方法 会 把 流程 定义 文件 内 容 持久 化 到 数据 库 ， 并 且 使 用 addClasspathResource(resourceName) 方 法 的 参数 作为 资源 名 称 。 

#4 处 用 于 验证 流程 定义 是 否 已 经 部 署 成 功 ， 根 据 流 程 定义 的 Key 属 性 查询 验证 已 经 部 署 的 流程 定义 数量 应 该 为 1。 

#5 处 用 于 验证 流程 定义 对 应 的 图 片 资源 是 否 部 署 成 功 ， 在 #5-S 处 得 到 一 个 流程 定义 对 象 ， 在 #5-1 处 获取 流程 定义 对 应 的 图 片 资 源 的 名 称 ， 在 #5-E 处 验证 图 片 资源 名 称 是 否 是 部 署 时 的 名 称 。 


classpath 方 式 一 般 用 于 开发 阶段 的 测试 环节 ， 真 正在 产品 环境 中 用 得 很 少 到 ， 而 是 通过 管理 界面 手动 部 署 或 在 设计 完 流程 之 后 直接 部 署 到 引擎 


5.2.2 InputSstream 方 式 


使 用 Inputstream 方 式 部 署 流程 资源 需要 传 入 一 个 输入 流 及 资源 的 名 称 ， 输 入 流 的 来 源 不 限 ， 可 以 从 classpath 读 取 ， 可 以 从 一 个 绝对 路 径 文件 读 取 ， 也 可 以 是 从 网 络 上 读 取 。 


下 面 以 代码 来 讲解 如 何 通过 Inputstream 方 式 部 署 流程 资源 ， 如 代码 清单 5-11 所 示 。 


代码 清单 5-11 用 Inputsteam 方 式 部 署 流程 资源 文件 


public class InputStreamDeploymentTest extends AbstractTest 1{ 
@Test // 从 一 个 绝对 文件 流 部 署 
public void testInputStreamFromAbsoluteFilePath() throws Exception { 
String filePath = "/Users/henryyan/work/books/aia-codes/bpmn20-example 
/src/test/resources/chapter5/userAndGroupInUserTask.bpmn"; J 


// 读 取 classpath 的 资源 为 一 个 输入 流 


FileInputStream fileInputStream = new FileInputStream(filePath); #2 
repositoryService.createDeployment () #3-S 
.addInputStream("userAndGroupInUserTask.bpmn", fileInputStream) .deploy(); #3-E 


// 验证 是 否 部 署 成 功 
ProcessDefinitionQuery pdgq = repositoryService.createProcessDefinitionQuery(); #4-S 
Jong count = pdq.processDefinitionKey ("userAndGrouplInUserTask") .count () ; #4-1 
assertEquals (1, count); #4-E 


代码 清单 5-11 列 出 了 用 绝对 路 径 的 文件 流 作为 InputStream 对 象 部 署 到 引擎 。 下 面 详 细 说 明了 每 行 代码 的 作用 。 
#1 处 定义 了 资源 文件 的 绝对 路 径 ， 读 者 在 运行 本 例 时 可 自行 更 改 为 自己 环境 的 实际 路 径 。 

#2 处 创建 了 一 个 文件 输入 了 对 象 。 

#3 处 用 “userAndGrouplnUserTask.bpmn” 作 为 资源 名 称 ， 以 filelnputstream 为 资源 文件 的 输入 流 部 署 到 引擎 
#4 处 先 (#4-S) 创建 一 个 流程 定义 查询 对 象 ， 然 后 统计 已 部 署 流程 的 数量 并 验证 数量 是 否 为 1。 


Inputstream 方 式 在 产品 环境 中 用 得 比较 多 ， 例 如 从 Web 客 户 端 接受 一 个 文件 对 象 部 署 到 引擎 中 ， 或 者 从 URL 读 取 文 件 流 后 部 署 到 引擎 中 。 


5.2.3 ”字符 串 方 式 


利用 字符 串 方 式 可 以 直接 传 入 纯 文 本 作为 资源 的 来 源 。classpath 方 式 和 Inputsteam 方 式 都 是 读 取 一 个 输入 流 后 部 署 资源 ， 和 这 两 种 方式 类 似 ， 字 符 串 方式 的 实现 原理 是 把 一 组 字符 串 的 内 容 转换 为 字 
节 流 后 再 部 署 。 代 码 清单 5-12 列 出 了 用 字符 串 方式 部 署 流程 的 代码 。 


代码 清单 5-12 ”用 字符 串 方式 部 署 流程 资源 文件 


public class StringDeploymentTest extends AbstractTest 
// XML 字符 串 ， 为 了 节约 版 面 省 略 了 定义 的 内 容 ， 读 区 可 罗 汶 甘 刚 的 源码 查看 全 部 内 容 
private String text = #1 
"<?xml version=\"1.0\" encoding=\"UTF-8\"?><definitions>http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15030/0EBPS/Text/...</c 


@Test 
public void testCharsDeployment () 
// candidateUserInUserTask. nn 为 资源 名 称 ， 以 text 的 内 容 为 资源 内 容 部 署 到 引擎 
repositoryService.createDeployment () 
.addString ("candidateUserInUserTask.bpmn", text) .qeploy() ， #2 
// 验证 流程 定义 是 否 部 署 成 功 


ProcessDefinitionouery pdq = repositoryService.createProcessDefinitionQuery () ， #3-S 
long count = pdq.processDefinitionKey ("candidateUserIinUserTask") .count () ， 
assertEquals (1, count); #3 一 EE 


代码 清单 5-12 的 #1 处 把 一 组 字符 串 赋值 给 text 变 量 ， 不 过 此 处 把 XML 的 内 容 省 略 了 。 读 者 可 参考 bpmn20- 
example/src/text/java/me/kafeitu/activiti/charpter5/deployment/StringDeploymentTest.java 类 ， 其 中 的 内 容 和 candidateUserlnUserTask.bpmn 文 件 一 样 。 


#2 处 用 addString0 方 法 设置 资源 名 称 为 “candidateUseriInUserTask.bpmn”， 内 容 为 text 的 变量 ， 之 后 调用 deploy 部 署 ， 结 果 与 用 classpath 和 InputSteam 一 样 。 


#3 处 依旧 验证 部 署 是 否 成 功 。 


5.2.4 ”zip/bar 格 式 压 缩 包 方 式 


以 上 3 种 部 署 方式 一 次 只 能 部 署 一 个 资源 ， 除 非 执行 多 次 deployment.addXxx() 方 法 ， 否 则 如 何 一 次 部 署 多 个 资源 呢 ? 很 简单 ，Activiti 允 许 把 一 批 资源 打包 部 署 ， 例 如 在 采用 classpath 方 式 部 署 的 例子 
中 同时 部 署 了 XML 格式 的 “candidateUserlnUserTask.bpmn” 文 件 和 图 片 格式 的 “candidateUserlnUserTask.png” 文 件 ， 用 压缩 包 方 式 部 署 可 以 把 这 两 个 资源 文件 打包 成 一 个 扩展 名 为 bar (bar 是 
Activiti 定 义 的 一 个 扩展 名 ， 使 用 zip 格 式 压缩 ) 的 压缩 文件 。 


打包 资源 文件 可 以 手动 操作 或 使 用 Ant 脚 本 ， 打 包 的 文件 扩展 名 可 以 是 Activiti 官 方 推荐 的 bar 或 普通 的 zip。 


本 小 节 以 candidateUserlnUserTask 和 userAnd-GrouplnUserTask 为 例 ， 目 的 是 一 次 部 署 这 两 个 流程 的 流程 定义 文件 和 对 应 的 图 片 文 件 ， 文 件 列 表 参 考 图 5-3。 首 先 打 包 图 5-3 中 的 4 个 文件 ， 命 名 压缩 
文件 为 “chapter5-deployment.bar”， 如 图 5-4 所 示 。 


如 果 是 手动 打包 文件 ， 可 以 先 用 压缩 工具 把 4 个 文件 压缩 成 zip 格 式 的 文件 ， 然 后 将 其 重 命名 为 bar 扩 展 名 的 文件 ,或 者 保持 zip 扩 展 名 。 


打包 之 后 就 可 以 通过 Activiti 的 API 部 署 打 包 的 bar 文 件 了 ， 见 代码 清单 5-13。 
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图 5-4 ”打包 4 个 资源 文件 并 命名 压缩 文件 为 charpter5-deployment.bar 


代码 清单 5-13 ”用 压缩 包 方式 部 署 流 程 资 源 文件 


public class ZipStreamDeploymentTest extends AbstractTest { 
@Test 
public void testZipStreamFromAbsoluteFilePath() throws Exception { 
// 从 classpath 读 取 资 源 并 将 其 部 署 到 引擎 中 
InputStream zipStream = getClass () .getClassLoader () 
.getResourceAsStream ("chapter5/chapter5-deployment .bar") ; #1 
repositoryService.createDeployment () 


.aqd2ZipInputStream (new ZipInputStream (zipStream) ) .deploy (); #2 
// 统计 已 部 署 流程 定义 的 数量 
long count = repositoryService.createProcessDefinitionQuery() .count () ; 
assertEquals (2, count); 3 


// 查询 部 署 记录 
Deployment deployment = repositoryService.createDeploymentQuery() .singleResult () ， #4-S 
assertNotNull (deployment); 


String deploymentId = deployment .getIqd(); #4-E 

// 验证 4 个 资源 文件 是 否 都 已 成 功 部 署 #5-S 

assertNotNull (repositoryService.getResourceAsStream(deployment1Id, "candidate UserIinUserTask.bpmn")); 

assertNotNull (repositoryService.getResourceAsStream (deploymentId, "candidate UserInUserTask.png")); 

assertNotNull (repositoryService.getResourceAsStream (deploymentId, "userAnd GroupInUserTask.bpmn")); 

assertNotNull (repositoryService.getResourceAsStream(deployment1Id, "userAnd GroupInUserTask.png")); #5-E 


代码 清单 5-13 从 classpath 中 读 取 一 个 bar 文 件 部 署 ， 最 后 验证 4 个 资源 文件 是 否 都 部 署 到 引擎 中 。 下 面 一 一 讲解 关键 代码 的 作用 。 
#1 处 代码 的 作用 读者 应 该 不 陌生 了 ， 从 classpath 中 读 取 一 个 资源 并 返回 一 个 输入 流 对 象 。 
#2 处 调用 addZiplnputstream() 方 法 部 署 一 个 zip 格 式 的 压缩 文件 ， 引 警 首先 会 将 其 解压 缩 ， 然 后 逐个 部 署 单 个 资源 文件 ， 相 当 于 用 for 循 环 方式 执行 了 n 次 Inputstream 部 署 。 


#3 处 验证 已 部 署 资源 的 数量 为 2。 这 里 肯定 有 读者 开始 疑惑 :压缩 包 中 明明 有 4 个 文件 ， 为 什么 部 署 之 后 只 有 两 个 ? 仔细 看 一 下 ， 代 码 #3 处 调用 的 方式 是 
repositoryService.createProcessDefinitionQuery0 查 询 已 部 署 的 流程 定义 对 象 ， 在 压缩 包 中 ，4 个 文件 有 两 个 扩展 名 为 bpmn、 两 个 扩展 名 为 png，3 引 | 擎 会 根据 不 同 的 扩展 名 进行 不 同 的 处 理 ，bpmn (或 
bpmn20.xml) 类 型 的 文件 会 在 流程 定义 表 中 插入 一 条 数据 并 在 存放 字 节 流 表 中 插入 数据 ， 而 PNG 类 型 的 文件 则 仪 在 存放 字 节 流 数 据 的 表 中 插入 一 条 数据 ， 所 以 只 有 扩展 名 为 bpmn 的 文件 才 会 作为 流程 定 
义 被 查询 到 。 


#4 处 用 于 查询 一 个 部 署 记 录 对 象 ， 解 释 一 下 什么 是 部 署 : “一 次 部 署 可 以 包含 单个 或 多 个 资源 文件 ， 调 用 一 次 DeploymentBuilder 的 deploy() 方 法 即 可 称 之 为 一 次 部 署 ”; 部 署 对 象 可 以 记录 本 次 部 署 
的 时 间 ， 并 且 本 次 部 署 的 资源 文件 记录 中 会 关联 本 次 部 署 的 ID;， 在 #4-E 处 的 变量 deploymentld 即 本 次 部 署 的 一 条 记录 的 ID。 


一 图 胜 干 语 ， 大 概 了 解 几 种 部 署 资源 的 方式 之 后 用 一 张 图 来 说 明 执行 的 过 程 ， 如 图 5-5 所 示 。 


图 5-5 从 “开始 部 署 ” 处 开始 一 次 部 署 操作 ， 然 后 保存 本 次 所 有 的 资源 到 字 节 流 库 中 ， 紧 接着 处 理 (解析 ) 本 次 部 署 的 资源 ， 流 程 引 警 内 置 了 两 个 处 理 器 (解析 流程 定义 、 解 析 规 则 文件 ) 用 来 解析 常用 
的 格式 ， 部 署 完 成 后 可 能 还 有 一 些 触 发 器 需要 执行 ， 例 如 定时 器 启动 事件 要 创建 一 个 作业 等 。 


保存 部 署 资源 
的 字 节 数据 、 
资源 名 称 


| 


对 于 不 同 的 扩展 
名 有 不 同 的 处 理 器 
> | 
部 署 流程 定义 
其 他 可 解析 资源 


我 要 负责 记录 
本 次 部 署 包括 
哪些 资源 、 部 
署 时 间 等 信息 


i bpmn20.xml z 
有 预 设 的 解析 前 ， 
可 以 目 定义 解析 各 


部 普 之 后 


执行 处 理 从 


图 5-5 ”一 次 部 署 执行 的 过 程 


5.3 ”流程 部 署 及 资源 读 取 
在 5.2 节 中 学 习 了 如 何 部 署 资源 ， 本 节 将 介绍 如 何 利用 ApPl 读 取 已 部 署 的 资源 ， 例 如 读 取 流程 定义 的 XML 文件 内 容 或 流程 对 应 的 图 片 文件 等 。 


本 节 又 进一步 接近 企业 应 用 中 实际 开发 的 需求 ， 在 Web 的 基础 上 构建 一 个 管理 流程 部 署 的 功能 模块 ， 可 以 查询 已 部 署 流程 、 上 传 文件 部 署 流程 、 读 取 流 程 资 源 (XML、PNG) 、 删 除 已 部 署 流程 定义 

本 节 的 示例 都 是 在 目前 最 受 欢 迎 的 MVC 框 架 Spring MVC 的 基础 上 实现 的 。Spring MVC 是 一 个 优秀 的 轻 量 级 Web 框 架 ， 和 Spring 无 缝 集成， 采用 松散 耦合 可 插 拔 组 件 结构 ， 相 比 其 他 的 MVC 框 架 有 着 
更 好 的 扩展 性 和 灵活 性 。Spring MVC 有 一 套 相 当成 熟 的 注解 支持 ， 可 以 很 容易 让 一 个 普通 的 POJO 对 象 变 成 一 个 控制 器 (和 Struts 2 的 Action 功 能 相同 ) 。 本 书 中 涉及 Spring MVC 的 地 方 均 使 用 注解 方式 
定义 Spring MVC 的 控制 器 (Controller) 。 


照顾 不 太 熟悉 Spring MVC 的 读者 ， 先 介绍 几 个 注解 的 含义 ， 示 例 代码 见 代 码 清单 5-14。 


代码 清单 5-14 ”快速 理解 Spring MVC 的 控制 器 的 示例 代码 


@QController 
QRequestMapping (value = "/workflow") 
public class ActivitiController { 
// 流程 定义 列表 
QRequestMapping (value = "/process-list") 
public ModelAndView processList() { 
ModelAndView mav = new ModelAndView ("workflow/process-list"); 
List<Object> objects = new ArrayList<Object> () ， 
mav.addobject ("objects", objects); 
return mav; 


} 

// 部 署 全 部 流程 

QRequestMapping (value = "/redeploy/all") 

public String redeployAll() throws Exception { 
workflowProcessDefinitionService.deployAllFromClasspath () ， 
return "redirect:/workflow/process-list"; 


} 


* (@Controller: 标记 当前 的 类 可 以 作为 Spring MVC 的 控制 器 。 


" (@RequestMapping: 定义 当前 控制 器 的 访问 路 径 ， 路 径 由 参数 value 指 定 ， 代 码 清 单 5-14 中 的 控制 器 的 访问 路 径 就 是 /workflow。 


. ModelAndView: SptingMVC 中 的 模型 和 视图 对 象 ， 顾 名 思 义 ， 可 以 在 返回 视图 的 同时 设置 模型 数据 变量 ， 在 返回 的 视图 中 就 可 以 读 取 模 型 对 象 的 变量 值 了 。 在 创建 ModelAndView 对 象 时 传 入 的 参数 即 


视图 的 路 径 ，mav.addObject("objects"，objects) 把 集合 objects 存 放 到 mav 中 ，ptocessList0 方 法 返回 了 mav 对 象 ，Spting MVC 根 据 配 置 的 视图 响应 客户 端的 请 求 。 
“ redirect: 重 定向 视图 到 冒号 后 面 的 视图 路 径 。 
本 节 内 容 的 代码 可 以 在 chapter5-oa-manager 项 目的 chapter5 中 找到 。 
5.3.1 读 取 已 部 署 流程 定义 
流程 定义 在 一 个 由 流程 驱动 的 业务 系统 中 是 必 不 可 少 的 ， 所 以 第 一 步 的 任务 就 是 要 有 一 个 列表 可 以 浏览 和 管理 流程 定义 ， 当 然 也 要 有 对 于 流程 定义 相关 的 资源 文件 的 浏览 和 管理 。 


图 5-6 展 示 的 就 是 一 个 已 部 署 流程 定义 列表 。 


全 I 昌国 己 地 轨 沪 和 定义 列表 --chapt x 且 “ 恒 


FE 


二 分 避 局 localhost:8080/chapter5-0a-manager/chapter5 /process-list 


流程 定义 ID 部署 ID ”流程 定义 名 称 ”流程 定义 KEY 版 本 号 ”XML 资源 名 称 图 片 资源 名 称 


图 5-6 ”已 部 署 流程 定义 列表 
从 图 5-6 的 列表 中 可 以 读 取 已 经 部 署 到 引擎 数据 库 的 流程 定义 ， 当 然 现 在 看 到 的 是 没有 任何 数据 显示 的 空 列 表 ， 暂 上 且 让 它 空 着 ， 重 点 是 了 解 一 下 如 何 读 取 流 程 定义 数据 。 
本 节 前 面 介绍 了 Spring MVC 的 一 些 特性 以 及 几 个 关键 的 注解 ， 现 在 看 看 图 5-6 中 列表 对 应 的 Java 代 码 是 如 何 实现 的 ， 见 代码 清单 5-15。 


代码 清单 5-15 ”用 Spring MVC 实 现 读 取 已 部 署 流 程 定义 列表 


@QController 
QRequestMapping (value = "/chapter5") 
public class DeploymentController extends AbstractController { 
QRequestMapping (value = "/process-list") 
public ModelAndView processList() { 
ProcessEngine processEngine = ActivitiUtils.getProcessEngine () ， #2 
RepositoryService repositoryService = processEngine.getRepositoryService(); 
// 对 应 WEB-INF/views/chapter5/process-list.jsp 
ModelAndView mav = new ModelAndView ("chapter5/process-list"); #3 
List<ProcessDefinition> processDefinitionList = #4 
repositoryService.createProcessDefinitionQuery() .list(); 
mav.addOobject ("processDefinitionList", processDefinitionList); 5 
return mav; 


代码 清单 5-15 和 代码 清单 5-14 中 讲解 Spring MVC 特 性 的 例子 类 似 ， 下 面 一 一 说 明 重 点 代码 的 含义 。 

#1 处 声明 processList0 方 法 的 访问 路 径 为 process-list， 该 路 径 和 类 DeploymentController 的 @RequestMapping 注 解 声 明 的 value 拼 接 起 来 就 是 : /chapter5/process-list。 
#2 处 用 工具 类 获取 Activiti 引 擎 对 象 。 

#3 处 创建 一 个 视图 对 象 ， 参 数 “chapter5/process-list” 对 应 的 路 径 为 “WEB-INF/views/chapter5/process-listjsp”。 

#4 处 用 于 查询 全 部 已 经 部 署 过 的 流程 定义 对 象 ， 也 可 以 通过 listPage() 方 法 分 页 查询 。 

#5 处 把 查询 结果 设置 到 ModelAndView 对 象 中 ， 相 当 于 调用 request.setAttribute0 方 法 。 

本 示例 的 View 层 使 用 JSP 实 现 ， 对 应 的 代码 也 比较 简单 ， 见 代码 清单 5-16。 


代码 清单 5-16 ” 读 取 已 部 署 流程 定义 的 View 代 码 


人 


table> 
thead> 
<tr> 


人 


th> 流 程 定 义 ID</th> 
th> 部 著 ID</th> 

th> 流 程 定 义 名 称 </th> 
th> 流 程 定义 KEY</th> 
th> 版 本 号 </th> 
th>XML 资 源 名 称 </th> 
th> 图 片 资源 名 称 </th> 


人 信人 信和 信人 入 信 


</tr> 

</thead> 

<C:forEach items="${processDefinitionList }" var="pd"> 
<tr> 


tad>$ {pd.iqd }</td> 

td>$ {pd.deploymentId }</td> 

td>$ {pd.name }</td> 

tdq>$ {pd.key }</td> 

td>$ {pd.version }</td> 

td>$ {pd.resourceName }</td> 

td>$ {pd.diagramResourceName }</td> 


AAAAAAA 


</tr> 
</c:forEach> 
</table> 


代码 清单 5-16 用 <c:forEach > 循环 输出 结果 中 的 每 一 个 流程 定义 对 象 ， 结 果 如 图 5-6 所 示 。 


5.3.2 ”从 客户 端 部 署 流程 


在 上 一 小 节 中 用 Spring MVC 和 JSP 实 现 了 读 取 已 部 署 流程 定义 的 功能 ,但 是 读 取 的 列表 为 空 ， 本 小 节 的 任务 就 是 从 客户 端 部 署 流程 定义 ， 然 后 用 上 一 小 节 的 列表 显示 已 部 署 流程 定义 及 其 资源 。 


在 5.2 节 已 经 介绍 了 多 种 部 署 方 式 ， 在 实际 的 企业 应 用 中 一 般 通 过 Web 界 面 或 其 他 客户 端 部 署 流程 定义 。 本 小 节 采 用 上 传 文件 方式 部 署 流程 定义 ， 支 持 讨 缩 包 方式 和 InputStream 方 式 部 署 。 


图 5-7 展 示 了 部 署 流程 资源 的 界面 。 


国 己 部署 流程 定义 列表 --chapter x 


@ | | | localhost:8080/chapter5-0a-manager/chapterS /process-list 


署 流程 资源 


支持 文件 格式 : zip、bar、bpmn、bpmn20.xml 


图 5-7” 部署 流 程 资源 的 界面 


5-7 对 应 的 HTML 代 码 见 代码 清单 5-17。 


代码 清单 5-17 图 5-7 对 应 的 HTML 代 码 


<form action="${ctx }/chapter5/deploy" method="post" enctype="multipart/form-data"> 
<input type="file" ="file" 


p f 
<input type="submit" value="Submit" class="btn" /> 
</ form> 


从 Web 端 部 署 的 过 程 比较 简单 ， 可 以 用 图 5-8 来 简单 描述 这 一 过 程 。 


了 解 了 部 署 过 程 之 后 再 从 代码 的 角度 剖析 过 程 细 节 ， 部 署 的 代码 还 是 在 类 Deployment-Controller 中 实现 的 ， 见 代码 清单 5-18。 


处 理 上 传 的 
文件 类 型 


zip/bar 类 型 的 文件 用 


ZipInputStream 方 式 部 署 判断 文件 类 型 


其 他 文件 类 型 直接 部 
显示 已 部 署 、 着 ，Activiti 内 置 的 几 
资源 列表 外 | 个 部 署 处 理 器 会 自动 

Hh 处 理 


图 5-8 ”从 Web 端 部 署 流程 资源 的 过 程 


代码 清单 5-18 ”部署 流 程 资 源 的 Java 代 码 


@QRequestMapping (value = "/deploy") #1 


public String deploy (GRequestParam(value = "file") MultipartrFile file) { #2 
RepositoryService repositoryService = processEngine.getRepositoryService(); 


// 获取 上 传 的 文件 名 


String fileName = file.getOriginalFilename () 
try { 
// 得 到 输入 流 〈 字 节 流 ) 对 象 
InputStream fileInputStream = file.getInputStream(); 
// 文件 的 扩展 名 
String extension = FilenameUtils.getExtension (fileName); #3 
/ zip 或 者 bar 类 型 的 文件 用 ZipInputStream 方 式 部 署 


/ 
DeploymentBuilder deployment = repositoryService.createDeployment () ， 
if (extension.equals ("zip") || extension.equals ("bar")) 1 #4-S 
ZipInputStream zip = new ZiplInputStream (fileInputStream); #4-1] 
deployment .addZipInputStream (zip); #4-E 
} else { 
// 其 他 类 型 的 文件 直接 部 署 
deployment .aqdqInputStream (fiLeName，fileInputStream) ， #5 
} 
deployment .deploy () ， 
} catch (Exception e) { 
logger.error ("error on deploy process, because of file input stream"); 


return "redirect:process-list"; #6 


} 


代码 清单 5-18 中 的 代码 正如 图 5-8 所 描述 的 过 程 那样 ， 处 理 不 同 格式 的 资源 并 部 署 到 引擎 

#1 处 声明 deploy() 方 法 的 访问 路 径 为 /deploy， 即 代码 清单 5-17 中 form 的 action 属 性 。 

#2 处 接受 前 端 界面 上 传 的 文件 对 象 。 

#3 处 用 工具 类 获取 文件 的 扩展 名 ， 对 于 不 同类 型 的 文件 有 不 同 的 处 理 方式 ， 所 以 要 使 用 不 同 部 署 方 式 。 

#4 处 判断 类 型 为 压缩 文件 后 使 用 5.2.4 节 介绍 的 部 署 方式 部 署 压 缩 包 ，。 

#5 处 不 做 任何 判断 直接 部 署 除 压缩 包 格式 之 外 的 资源 ， 如 果 部 署 的 文件 类 型 不 是 压缩 文件 (如 bpmn、bpmn20.xm| 或 其 他 类 型 的 文件 ) ， 那 么 使 用 5.2.2 节 介绍 的 Inputstream 部 署 方式 。 
#6 处 部 署 后 返回 5.3.1 节 的 流程 定义 列表 。 


在 Web 界 面 中 选择 了 流程 文件 “candidateUserln-UserTask.bpmn”， 如 图 5-9 所 示 。 


支持 文件 格式 : zip、bar、bpmn、bpmn20.xml 


Choose File | candidateU.,..Task.bpmn Submit 


图 5-9 ”在 Web 界 面 中 选择 部 署 的 流程 资源 
在 单 击 图 5-9 中 的 “Submit” 按 钮 之 后 ， 页 面 刷新 后 显示 刚刚 部 署 的 流程 定义 ， 如 图 5-10 所 示 。 


从 图 5-10 中 可 以 看 出 ， 列 表 中 多 出 了 一 条 数据 ， 在 5.3.3 和 5.3.4 节 将 介绍 如 何 读 取 已 部 署 流程 定义 的 XML 和 图 片 文 件 。 


支持 立 忻 格式 ; zip。bars bpmn、bpmn20.xml 


Choose File | No file shosen 


Submit 


部 
闫 
流程 定 尖 ID ID 流程 定 沁 名 称 流程 定 光 KEY 多 ML 资源 名 称 图 片 资 源 名 称 操作 


candidatelLlserlnlLlserTask:ld 1 candidatelLlserlinLserTask candidateLlserlnLserTask 1 candidatellserinUserTask .bpmn candidateLserinUserTask.candidateLserinUserTask,png | 删除 


图 5-10 部署 流程 后 列表 显示 了 部 署 成 功 的 流程 定义 


5.3.3 ” 读 取 流 程 定 义 的 XML 


在 代码 清单 5-13 的 #4 处 已 经 涉及 了 读 取 资源 的 代码 ， 对 应 的 代码 为 : repository-Service.getResourceAsStream(deploymentld，"candidateUserlnUserTask.bpmn")。 


本 小 节 在 图 5-10 的 基础 上 为 列表 中 的 “XML 资 源 名 称 ”添加 一 个 链接 ， 用 来 在 单 击 后 查看 流程 定义 的 XML 文 件 内 容 ， 把 原来 的 “<td> ${pd.resourceName}</td>” 蔡 换 为 下 面 的 代码 。 


“<td>$ {pqd.resourceName }</td>” 奉 换 为 下 面 的 代码 。 
<td><a target=" blank" 
href='${ctx }/chapter5/read-resource?pdid=$ {pd.id }&resourceName=$ {pd.resourceName }'>${pd.resourceName }</a></td> 


URL 中 的 “pdid” 参 数 为 流程 定义 ID，“resourceName” 为 资源 的 名 称 ， 在 列表 的 “XML 资 源 名 称 ” 单 元 格 中 就 显示 为 一 个 链接 ， 如 图 5-11 所 示 。 


XML 资源 


CanagldateuUserInUsSer | asK.DPrmn 


图 5-11 为 “XML 资源 名 称 ” 添 加 链接 后 的 显示 效果 


有 了 链接 后 的 任务 就 是 用 代码 实现 读 取 XML 内 容 的 功能 ， 不 过 在 讲解 代码 之 前 要 说 明 一 下 : 所 有 的 流程 资源 (不 管 是 XML、PNG 格 式 还 是 其 他 格式 的 资源 ) 均 通过 一 个 方 
法 “repositoryService.getResourceAsStream()” 读 取 。 代 码 清单 5-19 列 出 了 一 个 通用 的 读 取 资源 内 容 的 方法 。 


代码 清单 5-19” 读 取 流 程 资 源 的 Java 代 码 


QRequestMapping (value = "/read-resource") 
public void readResource (GRequestParam("pdid") String processDefinitionId, QRequestParam("resourceName") String resourceName, HttpServletResponse response) 
throws Exception { 
ProcessDefinitionQuery pdq = repositoryService.createProcessDefinitionQuery () ， 
ProcessDefinition pd = pdq.processDefinitionId (ProcessDefinitionId) .singleResult (); 
// 通过 接口 读 取 资 源流 


InputStream resourceAsStream = repositoryService #1-S 


getResourceAsStream (pd.getDeploymentId(), resourceName); #1-E 
// 输出 资源 内 容 到 相应 对 象 
byte[] b = new byte[1024]; #2-S 
int len = -1; 
while ((len = resourceAsStream.read(b, 0, 1024)) != -1) { 
response.getOutputSstream() .write(b, 0, len); 
} #2 一 EE 


} 


在 代码 清单 5-19 的 #1 处 通过 部 署 [D 和 资源 名 称 得 到 了 一 个 字 节 流 对 象 ， 在 #2 处 把 资源 的 字 节 流 输出 到 HttpServletResponse 中 。 单 击 图 5-11 的 链接 之 后 可 以 看 到 如 图 5-12 所 示 的 结果 。 


A 国 acanosraosocnaprers-n x 重 


要 全 避 | DD localhost:BoOB0/chanterd-oa-manager/chaptierd/read-resource?pdid=candidateLserlnUserTask. ld&resourceMName=candidatelJserinUserTask.bpmn 


This XML file does not appear to have any style ntormation assoclated with it. [he document tree 1s shown below. 


<definitions xmlns="http:,//www.omg.org/spec/BPMN/20100524/MODEL”" xmlns:xsi="http!://www.w3.0rg/2001/XMLSche 
xmlns:activiti="http://activiti,.org/bpm" xmlns:bpmndi="http:/ /Ww .omg.o0rg/spec/BPMN/20100524,/DI" 
xmlns:omgdoc="http!//Wwww.omg.org/spec/DD/20100524/DC" xmlns:omgdi="http!://Wwww.omg.org/spec/DD/20100524/DI" 
typeLanguage="http!i/ /Ww .Ww3.0rg/2001/XMLSchema" expressionLanguage="http://www.w3,.0rg/1999/XPpath" 
targetNamespace="http:/ /www. kafeitu.me/activiti-in-action"> 
T<process id="candidateUserInUserTask" name="candidateUserInUserTask" isExecutable="true"> 
«atartEvent id="starteventl1" name="Start" /> 
<userTask id="ugertaskl"” name=" 用 户 任务 包 售 多 个 直接 候选 人 ” activiti:candidateUsers="jackchen, henryyan'"/> 
<SBEQUENCeFlow id="flowl" name="" SOUrceRef="starteventl" targetRef="usertaskl" /> 
endEvent id="endeventl" name="End" /> 
<BSEgUENcCeFlow id="flow2" name="" soOurceRef="usertaskl" targetRef="endeventl"/> 
</process> 


图 5-12 ”通过 单 击 链接 显示 XML 资源 文件 内 容 


5.3.4” 读 取 流程 定义 的 图 片 及 图 片 中 的 中 文 乱码 


流程 定义 的 图 片 资源 是 和 流程 定义 关联 在 一 起 的 ， 它 的 基本 作用 是 可 以 让 用 户 清楚 整个 流程 需要 处 理 的 任务 及 流程 的 走向 ， 还 有 一 个 作用 是 可 以 在 流程 运行 过 程 中 显示 地 跟踪 流程 处 理 的 进度 ， 这 一 
在 第 6 章 中 将 会 详细 介绍 


一 个 流程 定义 会 对 应 一 个 图 片 资 源 。 图 片 可 以 由 引擎 自动 生成 ， 或 者 与 流程 定义 一 起 部 署 (压缩 包 方式 ) ， 这 样 引擎 不 再 自动 生成 图 片 资 源 ， 而 是 使 用 部 署 包 中 的 图 片 资源 。 图 5-13 很 好 地 描述 了 这 一 


从 图 5-13 中 可 以 看 出 ， 是 否 生成 图 片 分 为 两 种 情况 : 如 果 仅 仅 部 署 了 扩展 名 为 bpmn 或 bpmn20.xmI 的 文件 会 自动 生成 图 片 ; 如 果 部 署 的 是 一 个 压缩 包 ， 这 个 压缩 包 中 可 能 包含 很 多 个 文件 ， 甚 至 多 个 


流程 定义 文件 ， 若 压缩 包 中 不 包含 和 流程 定义 同名 的 图 片 文件 ， 则 引 警 同样 会 自动 生成 图 片 文件 。 


格式 : bpmn、 
bpmn20.xml 


生成 图 片 


自动 设置 流程 定义 
的 图 片 资 源 名 称 


图 5-13 ”流程 引擎 生成 流程 图 片 的 过 程 
首先 通过 示例 方式 展示 引擎 自动 生成 的 图 片 资 源 。 在 上 一 小 节 中 学 习 了 如 何 读 取 流 程 定 义 的 XML 资源 内 容 ， 知 道 了 不 管 XML 还 是 PNG 都 统称 为 “资源 ”， 而 且 也 了 解 到 读 取 所 有 资源 都 通过 一 个 接口 完 
成 ， 所 以 读 取 图 片 资源 和 读 取 XML 资 源 的 方式 一 样 。 
将 代码 清单 5-16 中 显示 图 片 资源 名 称 的 单元 格 用 如 下 代码 替换 ， 单 元 格 内 容 是 一 个 超级 链接 ， 显 示 效 果 如 图 5-14 所 示 。 


<td><a target=" blank" 
href="'${ctx }/chapter5/read-resource?pdid=$ {pd.id }&resourceName=$ {pd.diagram-ResourceName }'>${pd.diagramResourceName }</a></tqd> 


图 片 资源 名 称 


candidateUserInUserTask.candidateLUserinUserTask.png 


图 5-14 ”添加 了 超级 链接 的 图 片 资源 名 称 的 单元 格 显示 效果 


单 击 图 5-14 中 的 链接 之 后 在 新 窗口 中 显示 了 引擎 自动 生成 的 图 片 文件 ， 如 图 5-15 所 示 。 


在 部 署 流程 定义 文件 时 只 部 署 了 一 个 bpmn (或 bpmn20.xml) 为 扩展 名 的 文件 ， 根 据 图 5-13 的 流程 可 以 判定 图 5-15 的 流程 图 是 引擎 自动 生成 的 。 除 了 这 种 情况 外 还 有 一 种 情况 会 自动 生成 图 片 文 件 ， 
那 就 是 部 署 一 个 压缩 包 文 件 ， 但 是 其 中 仅仅 包含 流程 定义 文件 。 


需 帆 时 F 国 ad-resource (290x70) 


二 3 localhost:B080/chapter5-oa-manager/chapterS/read-resource?pdid=candidateUserinUss 


图 5-15 “在 打开 的 新 窗口 出 现 了 引擎 自动 生成 的 图 片 


还 是 以 流程 candidateUserlnUserTask 为 例 ， 图 5-16 是 用 压缩 工具 生成 的 一 个 压缩 文件 ， 只 包含 “candidateUserlnUserTask.bpmn” 一 个 文件 。 


与 | CandidateUserinUserTask.bpmn=only=bpmn.zip Today 9:24 PM 920 bytes ZIP Archive 


图 5-16 ”只 包含 一 个 bpmn 文 件 的 压缩 文件 


完成 部 署 之 后 在 已 部 署 流程 定义 列表 中 多 出 一 条 版 本 号 为 2 的 记录 ， 如 图 5-17 所 示 。 


部 大 版 本 
流程 定义 ID ID ”流程 定义 名 称 流程 定义 KEY 号 ”XML 资源 名 称 图 片 资源 名 称 


candidateUserinUserTask:1:4 1 candidateUserlnUserTask candidateUserinUserTask 1 candidateUserinUserTask.bpmn candidateUserinUserTask.candidateUserinUserTask.png 


candidateUserlnUserTask':2:8 5 candidatieUserlnUserTask candidateUserinUserTask 2 candidateUserinUserTask.bpmn candidateUserlinUserTask.candidateUserinUserTask.png 
图 5-17 在 已 部 署 流程 定义 列表 多 出 了 一 条 记录 

通过 单 击 版 本 号 为 2 的 记录 的 两 个 链接 可 以 看 出 ， 结 果 和 单 击 版 本 号 为 1 的 记录 一 样 ， 生 成 的 图 片 和 图 5-15 也 是 一 样 ， 这 也 再 次 证 明了 图 5-13 中 的 生成 图 片 的 逻辑 。 

看 到 了 图 片 是 不 是 突然 觉得 学 习 Activiti 的 动力 十 足 了 呢 ? 但 是 这 里 不 得 不 打击 一 下 大 家 ， 有 一 个 老生 常 谈 的 问题 ， 那 就 是 “中 文 乱码 ”。 图 5-18 展 示 了 流程 图 中 的 中 文 乱码 。 


导致 乱码 的 原因 是 字体 库 的 原因 ， 因 为 Activiti 引 | 警 默认 的 字体 名 称 为 “Arial”， 而 “Arial” 不 支持 中 文字 符 ， 解 决 办 法 也 不 难 ， 更 换 一 个 支持 中 文字 符 的 字体 即 可 。 


http://localhost:8080/chapterd—oa—nmnanager/chapters) 


br Wh 二 二 让 /localhost: S00) chapters—oa-manaezer) chap: IW | A 


— 


i i 


这 收 沁 让 [i http://localhost:8080/ chapterS-o0a-man. . ， 


D000000000... 


图 5-18 ”引擎 自动 生成 的 图 片 中 的 中 文 乱码 


@i 明 读者 比较 疑惑 的 可 能 是 : 为 什么 图 5-15 在 没有 更 改 字体 之 前 没有 出 现 乱码 问题 ? 这 和 操作 系统 有 关系 ， 笔 者 使 用 的 是 Mac OS 义 系 统 ， 而 图 5-18 的 乱 的 问题 是 在 Windows 平 台 上 产生 的 ， 所 以 在 
Windows 平 台 上 使 用 引擎 自动 生成 图 片 需要 更 改 字 体 名 称 。 


为 了 解决 中 文字 符 的 乱码 问题 不 得 不 侵入 源码 内 部 进行 更 改 ， 以 便 解决 这 个 读者 遇 到 最 多 的 问题 。Activiti 生 成 图 片 使 用 的 是 Awt (JDK 中 提供 的 画图 组 件 ) ,负责 生 成 图 片 的 Java 类 
为 “org.activiti.engine.impl.bpmn.diagram.ProcessDiagramCanvas”， 此 类 中 有 一 行 关键 代码 “Font font = new Font ("Arial"，Font.BOLD，11) ; ”， 其 中 加 粗 部 分 的 “Arial” 即 引擎 默认 的 字体 
文件 。 中 文 版 的 Windows 都 会 默认 自 带 “宋体 ”，Vista 以 上 版 本 自 带 “微软 雅 黑 ”等 中 文字 体 ， 要 解决 流程 图 中 的 中 文 乱码 问题 ， 只 需要 把 默认 的 字体 文件 改 为 操作 系统 中 支持 中 文 的 字体 文件 的 名 称 即 
可 。 图 5-19 显 示 了 把 “Arial” 改 为 宋体 文件 的 名 称 “simsun” 之 后 的 效果 ， 对 应 的 代码 如 下 : 


Font font = new Font ("simsun", Font.BOLD, 11); 


/http://localhost:8080/chapter5-0a-nanager/ chapters. 


A bp: | 一 属 盖 了 入 总 IT 盖 


pe 收藏 夹 加 http://localhost:8080/ chapterS=-oa=-man. . . 


六 
学 习 用 户 与 组 '… 


图 5-19 改 用 “宋体 ”字符 之 后 生成 的 图 片 正常 显示 中 文字 符 


流程 引擎 自动 生成 的 图 片 虽然 解决 了 乱码 问题 ， 但 是 解决 的 手段 比较 “另类 ” ， 需 要 入 侵 修改 源 代 码 ， 这 会 导致 在 升级 版 本 时 需要 同步 
类 “org.activitiengine.impl.bpmn.diagram.ProcessDiagramCanvas”， 并 且 再 次 修改 字体 名 称 。 细 心 的 读者 可 能 已 经 发 现 了 ， 当 任务 中 的 文字 比较 长 时 会 用 “.…” 代替 ， 这 在 实际 应 用 中 是 绝对 不 允许 
出 现 的 ， 在 未 来 版 本 中 会 修复 此 问题 (可 以 通过 修改 源码 的 方法 解决 ) 。 


在 国内 的 Activiti 社 区 中 经 常 有 人 问 到 流程 图 中 文 乱码 如 何 解决 ， 除 了 刚刚 介绍 的 修改 引擎 源码 中 字体 的 配置 方法 之 外 ， 笔 者 在 Activiti 5.12 版 本 发 布 之 前 对 此 做 了 修复 ， 允 许 通过 配置 的 方式 更 改 字体 名 
称 ， 例 如 ， 在 如 下 的 配置 中 把 字体 更 改 为 了 “宋体 ”。 


<bean id="processEngineConfiguration" 
class="org.activiti .xxx.XxxProcessEngineConfiguration"> 
ttp://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15030/0EBPS/Text/... 
1!-- 生成 流程 图 的 字体 --> 
<property name="activityFontName" value=" 宋 体 "/> 
<property name="labelFontName"” value=" 宋 体 "/> 
</bean> 


八 休 


修改 字体 名 称 的 解决 办 法 不 完美 ， 是 不 是 还 有 另外 的 办 法 解决 中 文 乱码 问题 呢 ” 答案 是 肯定 的 。 简 单 来 说 就 是 把 流程 定义 文件 和 同名 的 流程 图 片 文件 一 起 打包 后 部 署 。 暂 时 不 理解 没 天 系 ， 下 面 结 和 图 
来 进行 解释 。 图 5-20 展 示 了 一 个 名 称 为 “userAndGroupln-UserTask-with-bpmn-and-png.zip” 的 压缩 文件 ， 它 包含 了 两 个 文件 ， 分 别 为 “userAnd- 
GrouplnUserTask.bpmn” 和 “userAndGrouplnUserTask.png”。 


| UserAndGrouplnUserTask=with=bpmn=and=png.zip 


| Modified 
| userAndGroupinUserTask.bpmn 10/25/12 1:48 AM 2 KB 


车 userAndGroupinUserTask.png 10/25/12 1:48 AM 10 KB 


图 5-20 ”压缩 文件 userAndGrouplInUserTask-with-bpmn-and-png.zip 


接着 部 署 “userAndGrouplnUserTask-with-bpmn-and-png.zip” 文 件 ， 在 已 部 署 列表 中 显示 了 一 个 刚刚 部 署 的 userAndGrouplnUserTask 流 程 定义 ， 如 图 5-21 所 示 。 


部 版 
团 本 
流程 定 尖 ID ID 流程 定 党 名 称 流程 定 久 KEY 号 “XML 资源 名 称 图 片 资源 名 称 


candidateLlserinUserTask:1d4 1 candidateLlserinUserTask candidateLlserlinLUserTask 1 candidatelLlserinUserTask.bpmn candidatellserinLiserTask.candidatellserinLserTask.pnd 


UserAndGrouplnUserTask:1 5 UserAndGrouplnUserTask UserAndGrouplnUserTask 1 userAndGrouplnUserTask.bpmn userAndGrouplnUserTask,.png 


图 5-21 通过 压缩 文件 userAndGrouplInUserTask-with-bpmn-and-png.zip 部 署 的 流程 定义 


注意 图 5-21 中 的 第 一 条 记录 是 通过 部 署 candidateUsetInUsetTask.bpmn 文 件 生 成 的 ， 第 二 条 记录 是 通过 部 署 usefAndGtoupInUsetTask-with-bpmn-and-png'zip 文 件 生 成 的 。 不 同 的 方式 也 导致 “图 片 资源 
名 称 ” 显 示 的 不 同 : 由 引擎 自动 生成 的 图 片 文件 名 称 为 “candidateUserInUsetTask.candidateUserInUserTask.png”， 即 两 个 用 “.” 分 割 的 流程 定义 的 Key 组 成 ; 通过 压缩 包 方 式 (包含 图 片 ) 部 署 的 流程 定义 显 


示 的 “图 片 资源 名 称 ” 保 持 不 变 ， 如 果 压 缩 包 中 包含 多 级 目录 ， 则 路 径 部 分 用 “/” 分 割 ， 例 如 ，“aaa/bbb/userAndGroupInUsetTask.png ”。 


单 击 图 5-21 中 的 第 二 条 流程 定义 记录 的 “图 片 资源 名 称 ”的 超级 链接 ， 可 以 看 到 和 图 5-1 相 同 的 图 片 ， 如 图 5-22 所 示 。 


机 程 定 光 列表 =-chapter x ) 加 "ead-resource (290x70) 


| localhost:8080/chapter5-o0a-manager/chapterS /read-—r 


学 习 用 户 与 组 在 


图 5-22 ”通过 压缩 包 方 式 (包含 流程 定义 图 片 ) 部 署 之 后 查看 图 片 资 源 
从 图 5-18 和 图 5-22 中 可 以 比较 出 另外 一 个 不 同 之 处 ， 图 片 中 元 素 的 坐标 是 不 同 的 。 图 5-18 是 靠 顶 部 开始 泻 染 图 片 的， 原因 是 引擎 在 生成 图 片 的 时 候 丢 失 了 坐标 信息 ， 而 图 5-22 和 设计 时 保持 一 致 。 
两 种 解决 中 文 乱码 的 方式 各 不 相同 ， 表 5-1 列 出 了 两 种 方式 的 区 别 。 


表 5-1 两 种 解决 中 文 乱码 方式 的 区 别 


特 性 引擎 自动 生成 压缩 包 方 式 部 署 


过 长 的 文字 被 截取 、 坐 标 丢失 
图 片 元 对 的 完整 性 都 可 以 通过 修改 源码 解决 ) 和 部 署 时 的 图 片 一 致 


灵活 性 (添加 其 他 附加 文字 ， 美 


和 部 署 时 的 图 片 一 弄 
化 图 片 等 ) 和 部 章 时 的 图 片 一 致 


ee nv. 须 提 流程 定 义 文件 和 同名 的 
部 省 方 工 仅 需 提供 流程 定义 文件 ， 
罩 方 式 仪 需 提 供 流 程 定义 文件 4 日 要 打包 为 | FE 缩 文件 


除了 使 用 引 警 的 AWT 提 供 的 流程 图 生成 功能 外 ， 还 可 以 使 用 Activiti 官 方 提 供 的 Diagram Viewer 组 件 生成 流程 图 ， 该 组 件 使 用 前 端的 Javascript、SVG (不 支持 SVG 时 使 用 VML) 、CSS 等 技术 实现 ,不 
需要 Activiti Rest 模 块 提供 服务 。 有 关 该 组 件 的 集成 与 使 用 在 20.6 节 有 详细 介绍 。 


5.3.5 ”删除 部 署 
前 面 花 了 不 少 篇 幅 讲解 如 何 部 署 和 读 取 流程 资源 ， 本 小 节 将 讲解 如 何 删 除 已 经 部 署 的 流程 定义 (包括 图 片 资源 ) 。 


我 们 以 流程 管理 用 例 为 出 发 点 ， 首 先 在 如 图 5-10 所 示 的 流程 定义 列表 页 面 添加 一 个 删除 部 署 的 入 口 ， 如 图 5-23 所 示 。 


流程 定义 ID 部 署 ID ”流程 定义 名 称 流程 定义 KEY 版 本 号 XML 资源 名 称 图 片 资源 名 称 


USerAndGrouplnUserTaskK1:8 userAndGrouplnUserTask userAndGrouplnUserTask 1 UserAndGrouplnUserTaskbpmn UserAndGrouplnUserTask.png 


5 为 部 署 的 ID 


图 5-23 ”在 列表 中 添加 删除 部 署 的 超级 链接 
一 个 流程 定义 不 能 直接 删除 ， 而 需要 通过 流程 定义 的 部 署 1D 删 除 。 在 执行 删除 操作 时 会 同时 删除 所 有 和 本 次 部 署 有 关 的 资源 ， 如 果 只 部 署 了 一 个 bpmn 或 bpmn20.xm| 流 程 定义 文件 ， 则 会 删除 流程 定 
义 及 引擎 生成 的 图 片 资 源 ; 如 果 使 用 压缩 包 来 部 署 资源 ， 则 将 其 全 部 删除 。 


图 5-23 中 “删除 ”对 应 的 代码 如 下 : 


<td><a target=" blank" 
href='${ctx }/chapter5/delete-deployment?deploymentId=$ {pd.deploymentIqd } "> 删除 </a></td> 


删除 部 署 的 Java 代 码 见 代码 清单 5-20。 


代码 清单 ?5-20 ”删除 部 署 的 Java 代 码 


GReduestMapping (value = "/delete-deployment") 

public String deleteProcessDefinition (GRequestParam("deployment1Id") String deploymentId 
// 调用 删除 部 署 的 API 

reposi OPYyS Sey ce.deleteDeployment (deploymentId, true); #1 
return "redirect:process-list"; 


} 


a 
一 


代码 清单 5-20 比 较 简 单 ， 除 了 接受 参数 返回 列表 之 外 ， 最 重要 的 就 是 #1 处 调用 RepositoryService 接 口 的 deleteDeployment() 方 法 ， 通 过 传 入 一 个 部 署 的 ID 删除 一 个 流程 ; 第 二 个 参数 “true” 表示 该 


部 署 包 含 的 流程 定义 已 经 被 运行 中 或 已 结束 的 流程 实例 使 用 ， 因 此 同时 把 和 流程 相关 的 流程 数据 也 一 并 删除 。 


5.4 本章 小 结 


本 章 介绍 了 Activiti 流 程 引擎 的 两 个 比较 重要 的 “服务 性 ”功能 : 用 户 与 组 、 部 署 管理 ， 对 每 一 个 功能 最 重要 的 理论 及 API 的 使 用 都 进行 了 详细 说 明 ， 并 且 通 过 实战 方式 进一步 加 深 理解 。 
在 关于 用 户 与 组 方面 ， 首 先 单独 介绍 每 一 个 对 象 的 管理 方法 ， 然 后 讲解 了 如 何 结合 流程 实例 中 的 用 户 任务 一 起 使 用 ， 最 后 说 明了 候选 组 与 候选 人 之 间 的 区 别 及 关系 。 

在 关于 流程 部 署 方 面 ， 用 单独 的 篇 幅 介 绍 了 多 种 部 署 方 式 ， 详 细 地 说 明了 每 种 部 署 方 式 的 实现 方法 及 应 用 场合 ， 在 5.2.4 节 用 流程 图 的 方式 解释 了 一 个 资源 部 署 到 引擎 的 过 程 。 

在 5.3 节 中 介绍 了 如 何 读 取 已 部 署 资源 ， 包 括 列表 、XML 文 件 、 图 片 文 件 等 ， 还 有 很 多 读者 最 关心 的 中 文 乱码 问题 的 解决 方案 。 


本 章 内容 作 为 “实战 篇 ”的 基础 组 件 存 在 ， 熟 悉 本 章 内 容 对 于 掌握 本 篇 其 他 章节 内 容 大 有 帮助 ， 涉 及 用 户 与 组 及 流程 部 署 方 面 的 功能 都 依赖 本 章 内 容 的 功能 实现 。 


第 6 章 任务 表单 


本 章 将 一 步 一 步 完 成 一 个 协同 办 公 系 统 (OA) 的 请 假 流程 的 设计 ， 从 实用 的 角度 来 考虑 问题 ， 讲 解 如 何 把 Activiti 和 实际 的 业务 紧密 结合 起 来 。 


在 4.1.1 节 中 简单 描述 了 两 种 表单 的 区 别 ， 即 动态 表单 和 外 置 (FormKey) 表单 的 区 别 ， 本 章 将 详细 介绍 如 何 使 用 不 同 的 表单 完成 相同 的 功能 。 


6.1 动态 表单 


在 第 2、3、4 章 中 已 经 涉及 了 请 假 流 程 的 设计 ， 但 是 业务 逻辑 的 摘 述 都 比较 粗糙 ， 本 章 的 请 假 流程 作为 一 个 接近 于 实际 应 用 ， 所 以 需要 重新 设计 。 重 新 设计 的 请 假 流程 定义 如 图 6-1 所 示 。 


部 门 领导 审批 


请 求 被 驶 回 后 员工 可 以 
选择 继续 申请 ， 或 者 取 
消 本 次 申请 


结束 流程 
图 6-1 ”请假 流 程 的 业务 流程 图 


图 6-1 描 述 了 请 假 流程 的 几 个 用 户 任务 及 业务 逻辑 的 判断 ， 首 先 员 工 自主 启动 一 个 请 假 流 程 ， 然 后 由 部 门 经 理 和 人 事 经 理 审 批 ， 全 部 审批 通过 之 后 流程 流转 至 销假 节点 ， 申 请 人 完成 “销假 ”任务 后 结束 
本 次 流程 。 如 果 部 门 经 理 或 人 事 经 理 审批 没有 通过 ， 则 由 员工 自己 选择 是 调整 信息 后 继续 申请 还 是 取消 本 次 申请 。 


全 所 示 本 节 内 容 均 存放 在 本 书 配套 资源 文件 的 “chapter6-oa-forms” 项 目 中 。 
6.1.1 流程 定义 
由 于 流程 的 代码 比较 多 ， 图 6-1 的 XML 代码 将 以 分 段 方式 进 解 ， 先 来 看 代码 清单 6-1。 


代码 清单 6-1 图 6-1 请 假 流程 的 开始 节点 XML 定义 


<process id="leave"” name=" 请 假 流程 -动态 表单 "> 


<startEvent Idq="startevent1" name="Start" activiti:initiator="applyUserId"> 
<extensionElements> 
<activiti:formproperty id="startDate" name=" 请 假 开 始 日 期 " type="date" 
datePattern="yyyy-MM-dd" required="true" readable="true" 
writable="true"></activiti:formproperty> 
<activiti:formProperty id="endDate"” name=" 请 假 结束 日 期 " type="date" 
datePattern="yyyy-MM-dd" required="true" readable="true" 
writable="true"></activiti:formproperty> 
<activiti:formProperty id="reason"” name=" 请 假 原因 " type="string" required="true" 
readable="true" writable="true"></activiti:formPproperty> 
</extensionElements> 
</startEvent> 
</process> 


在 4.1.1 节 中 已 经 简单 说 明了 activiti:initiator 属 性 的 作用 : 可 以 把 启动 流程 实例 的 操作 人 以 变量 名 称 “applyUserld” 保 存 到 数据 库 中 ， 需 要 配合 identityService.setAuthenticated-Userld (String 
userld) 方法 使 用 ， 其 中 userldq 即 当前 操作 人 ， 在 实际 的 应 用 中 应 该 是 当前 的 用 户 ID， 引 擎 会 把 setAuthenticatedUserld() 方 法 的 参数 作为 流程 启动 人 ， 通 过 调用 HistoricProcesslnstance 实 例 的 
getStartUserld0 可 以 获取 一 个 历史 (也 可 能 正在 运行 ) 流程 实例 由 哪个 用 户 启动 。 要 获取 设置 的 用 户 ID， 可 以 通过 调用 Authentication.getAuthenticatedUserld() 方 法 来 实现 。 


从 代码 清单 6-1 中 可 以 看 出 空 启动 事件 一 共 定义 了 三 个 字段 ,分 别 用 来 描述 请 假 的 开始 日 期 、 结 束 日 期 和 请 假 原 因 。 每 一 个 字段 都 配置 了 几 个 属性 ， 每 个 属性 的 含义 如 表 6-1 所 示 。 


type 


Value 


expression 


variable 


default 


datePattern 


readable 
writable 


readable 


表 6-1 activiti:formPtropetty 属 性 列表 


属性 说 明 
字段 的 唯一 标识 ， 对 应 html 元 素 的 id 属性 ， 在 保存 字 
用 来 描述 字段 的 名 称 


字段 的 类 型 ，Activiti 默认 文 持 几 种 类 型 : 
D string， 对 应 类 为 org.activiti.engine.impl.form.StringFormType 


段 时 就 是 用 此 字段 作为 Key 


字段 的 Name， 


口 long， 对 应 类 为 org.activiti.engine.impl.form.LongFormType 
口 enum ， 对 应 类 为 org.activiti.engine.impl.form.EnumFormType 
UD date, 


口 boolean， 对 应 类 为 org.activiti.engine.impl.form.BooleanFormType 
除了 以 上 的 几 种 类 型 ， 也 可 以 目 定 义 字 段 类 型 以 满足 实际 需求 
字段 的 值 
表达 式 ， 可 以 通过 


对 应 类 为 org.activiti.engine.impl.form.DateFormType 


二 计算 表达 式 设置 字段 的 值 ， 例 如 expression= " #fleave.reason}" 可 以 从 变 


量 名 为 leave 的 变量 中 获取 属性 reason 的 值 


将 字段 的 值 以 variable 指定 的 变量 名 保存 
字段 的 默认 值 

属性 type 的 值 为 “date” 
是 否 可 以 读 

是 否 可 写 
是 否 必 填 项 


时 需要 设置 此 属性 定义 日 期 格式 ， 例 如 ，yyyy-MM-dd 表示 2012-12-20 


这 个 不 是 属性 ， 而 是 当 type= "enum " 时 需要 指定 多 个 可 选 
人 多 个 activiti:value 标签 ， 例 如 : 


值 ， 在 activiti:formKey 标签 中 髓 


<activiti:formPproperty id="deptLeaderPass" name=" 
审批 意见 " 


writable="true"> 


type="enum" required="true" 


form values 


<activiti:value id="true"” name=" 同意 " /> 
<activiti:value id="false"” name=" 拒绝 "/> 


相克 


表 6-1 除 了 列 出 的 字段 属性 之 外 ， 还 有 一 个 针对 于 type= "enum "的 特殊 标签 <activiti:formProperty/> ， 可 以 在 标签 内 定义 多 个 <activiti:value/> 来 表示 多 个 候选 值 ， 适 用 于 页 面 中 的 下 拉 框 (htm 的 
select 组 件 ) ， 典 型 的 配置 可 以 参考 代码 清单 6-2 的 #1-1~#1-2 处 。 


代码 清单 6-2 列 出 了 用 户 任务 “部 门 领 导 审 批 ” 的 XML 定义 。 


代码 清单 6-2 ”图 6-1 请 假 流 程 的 部 门 领导 审批 用 户 任务 的 XML 定义 


部 门 领导 审批 " #1-S 
>  // 把 任务 分 配给 角色 “dept 


tartDate" name=" 请 假 开始 日 期 " type="date" 
val {startDate}" atePattern="yyyy-MM-dd" readable="true" 
le="false' 1 iviti:formproperty> 
property i9-"endDate”namer 请 假 结束 日期 type="date" 
{endDate}™" atePpattern="yyyy- 区 readable="true" 
le="false' 2 iviti:formPproperty 
Property id="reason" name "请 假 ) 周 因 ， type="string" value="$ {reason}" 
e="true" table="false"></activiti:formProperty> 
<activi FormPpropert LeaderApprove" name=" 审 批 意见 " type="enum" 
required="t le="true"> 
tiviti: ='"true" name=" 同 意 "></activiti:value> 
<activiti:val "false" name=" 拒 绝 "></activiti:value> 
</activiti: 


formProperty> #1-2 
</extensionl 


Elements> 
</userTask> 1-E 
<exclusiveGa 
<sequenceFlow igd=" 


name=" 
Leader" 


LeaderAudit" 


<userTask igd="dept] 

activiti:candidateGroups="dept 
<extensionElements> 

<activi Property id=" = 


Leader” 


<acti 


本 


<acti 


#1 


#2 


teway igd=" 'exclusivegateway35" name="Exclusive Gateway"/> 
flow4" E 绝 " 


name=" 拒 乡 
SOUTCeRef="exclusivegateway5" targetRef="modi 
<conditionExpression xsi:type="tFormalExpression"> 

<! [CDATA[S {deptLeaderApprove== 'false'}]]></conditionExpression> 
</sequenceFlow> 
<sequenceFlow id="flow5"” name=" 同 意 " sourceRef="exclusivegateway5" targetRe 
<conditionExpression xsi:type="tFormalExpression"> 
<! [CDATA[${deptLeaderApprove== 'tr 


ue'}]]1></conditionE 
</sequenceFlow> 


FyApply"> 


EA 


'xpression> 


从 代码 清单 6-2 的 #1-S 处 开始 定义 了 用 户 任 务 的 表单 ， 
为 “enum” 并 提供 了 两 个 候选 值 作为 SELECT 元 素 的 选项 。 


该 表单 多 了 一 个 “审批 意见 ”字段 ， 供 部 门 领导 决定 本 次 申请 的 处 理 结果 ， 是 同意 申请 还 是 拒绝 申请 ， 设 置 了 activiti:formProperty 的 类 型 


从 代码 清单 6-2 的 #2 处 开始 定义 了 用 户 任 务 “ 部 门 领导 审批 ”在 不 同 条 件 下 处 理 方式 : 当 表 达 式 “${deptLeaderApprove= = false}” 成 立时 ， 将 输出 流 指 定 到 ID 为 “modifyApply” 的 用 户 任务 ， 
即 “ 调 整 申请 ”; 当 表 达 式 “${deptLeaderApprove=='true'})” 成 立时 ， 将 输出 流 指 定 到 ID 为 “hrAudit” 的 用 户 任 务 ， 即 “人 事 审批 ”。 


代码 清单 6-3 列 出 了 用 户 任 务 “ 人 事 审批 ”的 XML 定 义 ， 结 构 和 “部 门 领导 审批 ”类 似 ， 不 同 的 仅 仪 是 审批 意见 的 字段 ID 不 同 。 


代码 清单 6-3 ”图 6-1 请 假 流 程 的 人 事 审批 用 户 任务 的 XML 定义 


<userTask id="deptLeaderAudit" name=" 人 事 审批 " activiti:candidateGroups="hr"> #1 
<extensionElements> // 把 任务 分 配给 角色 “hr” 
ee // 省 略 了 请 假日 期 和 请 假 原因 字段 定义 
<activiti:formproperty id="hrApprove"” name=" 审 批 意见 " type="enum" 
required="true" writable="true"> 
<activiti:value id="true" name=" 同 意 "></activiti:value> 
<activiti:value id="false" name=" 拒 绝 "></activiti:value> 
</activiti:formproperty> 
</extensionElements> 


</userTask> 

<exclusiveGateway id="exclusivegateway6" name="Exclusive Gateway" /> #2 
<sequenceFlow id="flow6" name="" sourceRef="hrAudit" targetRef="exclusivegateway6"/> 
<sequenceFlow id="flow7" name=" 同 意 " sourceRef="exclusivegateway6" 


targetRef="reportBack"> 
<conditionExpression xsi:type="tFormalExpression"> 
<! [CDATA[$ {hrApprove == 'true'}]]></conditionExpression> 
</sequenceFlow> 
<sequenceFlow id="flow9"” name=" 拒 绝 " sourceRef="exclusivegateway6" 
targetRef="modifyApply"> // 


<conditionExpression xsi:type="tFormalExpression"> 
<! [CDATA[$ {hrApprove == 'false'}]]></conditionExpression> 
</sequenceFlow> 


值得 注意 的 是 用 户 任 务 “ 部 门 领导 审批 ”和 “人 事 审批 ”请 假 相关 字段 的 “writable” 属 性 都 为 “false”， 只 有 “审批 意见 ”字段 的 “writable” 属 性 为 “true”。 


从 代码 清单 6-3 的 #2 处 开始 定义 了 用 户 任务 “人 事 审批 ”在 不 同 条 件 下 的 处 理 方式 : 当 表 达 式 “${hrApprove == 'false'}” 成 立时 ， 将 输出 流 指定 到 ID 为 “modifyApply” 的 用 户 任务 ， 即 “调整 申 
请 ”; 当 表 达 式 “${hrApprove == 'true'}” 成 立时 ， 将 输出 流 指定 到 ID 为 “reportBack” 的 用 户 任 务 ， 即 “销假 ”。 


假如 部 门 领导 和 人 事 经 理 都 审批 通过 了 ， 那 么 现在 任务 就 会 再 次 交 由 申请 人 办 理 ， 也 就 是 “销假 ”节点 ， 由 申请 人 填写 实际 的 请 假 时 长 。 销 假 用 户 任 务 的 XML 描 述 如 代码 清单 6-4 所 示 。 


代码 清单 6-4 图 6-1 请 假 流 程 的 销假 用 户 任务 的 XML 定义 


<userTask id="reportBack" name=" 销 假 " activiti:assignee="${applyUserId}"> # 工 
<extensionElements> 
// 请 假 的 信息 和 部 门 领导 审批 节点 相同 
<activiti:formproperty id="reportBackDate"” name=" 销 假日 期 " type="date" #2 
datePattern="yyyy-MM-dd" required="true" readable="true" 
default="$ {endDate}" writable="true"></activiti:formProperty> 
</extensionElements> 
</userTask> 
<sequenceFlow id="flow8"” name=" 销 假 " sourceRef="reportBack" targetRef="endevent1"> 
<extensionElements> 
<activiti:executionListener event="take" 
expression="$ {execution.setVariable('result', 'ok')}"/> #3 
</extensionElements> 
</sequenceFlow> 


在 代码 清单 6-4 中 需要 读者 特别 注意 ，#1 处 的 activiti:assignee 属 性 使 用 表达 式 的 方式 指定 任务 办 理 人 “${applyUserld}y”， 在 代码 清单 6-1 的 空 启动 事件 中 定义 了 activiti:initiator= “applyUserld”， 
所 以 销假 节点 就 可 以 直接 使 用 变量 applyUserld 的 值 作为 办 理 人 的 ID， 这 样 用户 任 务 会 自动 分 配给 申请 人 。 


#2 处 添加 了 一 个 字段 “销假 日 期 ”并 指定 “writable” 属 性 为 “true”， 可 以 由 申请 人 填写 请 假 的 实际 结束 日 期 。 
在 #3 处 ， 当 申请 人 销假 之 后 执行 表达 式 “${execution.setVariable('result'，'ok')}”， 将 当前 流程 实例 的 变量 名 “result” 设 置 为 “ok”。 


以 上 情况 都 是 假设 部 门 领导 和 人 事 经 理 都 审批 通过 。 根 据 流程 定义 可 以 分 析出 : 如 果 部 门 经 理 和 人 事 经 理 中 的 一 个 审批 未 通过 ， 则 把 输出 流 指定 到 用 户 任务 “调整 申请 ” ， 并 且 该 任务 的 排他 分 支 有 两 
个 输出 流 ， 一 个 是 “重新 申请 ”， 另 外 一 个 是 “结束 流程 ”。 代 码 清单 6-5 列 出 了 “调整 申请 ”用 户 任务 的 XML 定 义 。 


代码 清单 6-5 ”图 6-1 请 假 流程 的 调整 申请 用 户 任务 的 XML 定义 


<userTask id="modifyApply" name=" 调 整 申请 " activiti:assignee="${applyUserId}"> 
<extensionElements> 
<activiti:formProperty idq="startDate" name=" 请 假 开 始 日 期 " type="date" 
value="${startDate}" datePattern="yyyy-MM-dd" required="true" readable="true" #1 
writable="true"></activiti:formproperty> 


<activiti:formProperty id="endDate"” name=" 请 假 结束 日 期 " type="date" 

value="$ {endDate}" datePattern="yyyy-MM-dd" required="true" readable="true" #2 
writable="true"></activiti:formproperty> 

<activiti:formProperty igd="reason" name=" 请 假 原 因 " type="string" value="${reason}" #3 
required="true" readable="true" writable="true"></activiti:formProperty> 


<activiti:formProperty id="reApply"” name=" 重 新 申请 " type="enum" required="true" #4 
writable="true"> 
<activiti:value id="true" name=" 重 新 申请 "></activiti:value> 
<activiti:value id="false" name=" 取 消 申请 "></activiti:value> 
</activiti:formproperty> 
</extensionElements> 
</userTask> 
<sequenceFlow idq="flow10" name=" 重 新 申请 " sourceRef="exclusivegateway7" #5 
targetRef="deptLeaderAudit"> 
<conditionExpression xsi:type="tFormalExpression"> 


<! [CDATA[${reApply == 'true'}]]></conditionExpression> 
</sequenceFlow> 
<sequenceFlow idq="flow12" name=" 结 束 流程 " sourceRef="exclusivegateway7" 
targetRef="endevent1"> 
<extensionElements> 


<activiti:executionListener event="take" 
xpression="$ {execution.setVariable('result', 'canceled')}"/> #6 
</extensionElements> 
<conditionExpression xsi:type="tFormalExpression"> 
<! [CDATA[${reApply == 'false'}]]></conditionExpression> 
</sequenceFlow> 


第 一 眼看 上 去 ， 代 码 清单 6-5 和 代码 清单 6-1 的 XML 代码 基本 一 样 ， 但 是 注意 #1、#2、#3 处 加 粗 的 属性 value， 申 请 人 在 启动 流程 时 填写 的 表单 字段 可 能 需要 再 次 修改 ， 所 以 通过 设置 value 属 性 获取 表 
单字 段 值 。 


从 #5 处 开始 根据 申请 人 的 选择 来 判断 是 重新 申请 还 是 取消 申请 (结束 流程 ) 。 


在 #6 处 ， 当 申请 人 销假 之 后 执行 表达 式 “${execution.setVariable('result', canceled)}” ， 将 当前 流程 实例 的 变量 名 “result” 设置 为 “canceled” 。 


6.1.2 单元 测试 


6.1.1 节 对 整 
代码 清单 6-6 用 单元 测试 方式 验证 了 在 请 


代码 清单 6-6 


个 动态 表单 的 i 


青 作 


当 部 门 领导 和 人 事 经 理 全 部 审批 通 


my 口 
和 流程 


定义 XML 做 了 详细 的 讲解 ， 本 节 将 对 


假 流 程 中 部 门 领 导 和 人 事 经 理 审批 通 


过 时 的 单元 测试 


public class LeaveDynamicFormTest extends AbstractTest { 
@Test 


QDeployment (resources = "chapter6/dynamic-— 
public void allApproved() throws 
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tem.out.println ("variable: 


return historyVariables; 


#1 处 设置 的 是 当前 用 户 的 ID， 


存 启 


#2-2 处 使 用 了 一 个 新 的 APl, 
个 方法 在 执行 启动 流程 实例 时 会 从 第 二 


一 及- 一 


异 单 ， 


#3-1 和 #4-1 处 代码 类 似 ， 唯 一 不 同 的 是 : 
#3-E、#4-E、##5-E 这 三 处 的 功能 是 


#7-S 处 用 来 读 取 历 史 流 程 (已 
吉 束 后 从 历史 变量 中 查询 “result” 的 值 等 于 “ok” 即 表 


流程 人 的 ID， 从 输出 结果 可 以 看 出 applyUserld 的 变量 


这 样 当 流 程 在 运行 i 


eUpdate) 
(HistoricVariab] 


tyValue () ); 
E 0 
+ field.getPropertyValue () ) ， 
{ // 普通 变 
ntity) hist 


ER 


#8 一 忆 
oricDetail; 


三 中 


里 


eUpdateE 
ue ()); 


"+ variable.getName () 1 


过 程 中 需要 获取 当前 操作 人 时 会 通 i 
值 为 “henryyan”， 


和 runtimesService.startProcesslnstance() 功 


个 参数 (variables) 中 读 取 和 表单 字段 ID 相 同 的 项 作为 表单 字段 的 值 ， 如 果 某 个 


并 且 根 据 设置 的 字段 类 型 调用 对 应 的 类 型 转换 器 来 转换 字段 值 。 


两 者 还 


不 有 一 个 很 重要 的 区 别 : 


果 是 否 保存 到 了 数据 库 ， 流 程 结 


#8 处 根据 接口 HistoricDetail 的 实际 类 型 进 


通过 formService.submitStartFormData() 启 动 流程 时 字段 的 值 只 能 为 “字符 型 


提 


竺 办 理 过 的 任务 、 流 程 


交 任 务 表单 并 完成 任务 。 


设置 不 同 的 变量 为 “true” 表 示 这 两 个 


了 区 分 ， 输 出 结果 如 下 : 


variable: applyUserlId = henryyan 

form field: taskId=null, startDate = 2012-11-26 
form field: taskId=null，reason = 公休 

Form field: taskId=null, endDate = 2012-11-28 
variable: startDate = Mon Nov 26 00:00:00 CST 2012 
variable: endDate = Wed Nov 28 00:00:00 CST 2012 
variable: reason = 公休 

form field: taskId=19, deptLeaderApproved = true 
variable: deptLeaderApproved = true 

form field: taskId=26, hrApproved = true 

variable: hrApproved = true 

form field: taskId=33, reportBackDate = 2012-11-28 
variable: reportBackDate = Wed Nov 28 00:00:00 CST 2012 
variable: result = ok 


以 “form field: 
同时 会 


旦 . 
时 


复制 一 份 经 过 


(字符 型 ) ， 


”开头 的 输出 结果 是 表单 字段 内 容 ， 其 他 以 “variable: 
才 类 型 转换 的 值 ， 并 以 字段 的 ID 为 变 
“startDate” 的 值 为 “2012-11-26” 


variable.ge 


过 调用 identityService.setAuthenticatedUserld() 方 法 来 实现 ， 在 空 启动 事件 上 设置 


tValue () ) ， 


分 析 ， 后 面 列 出 了 单元 测试 的 执行 结果 。 


9 变量 “applyUserld” 用 来 保 


因此 在 实际 应 用 中 启动 流程 前 调用 此 方法 便 显得 格外 重要 。 
能 类 似 一 一 启动 一 个 新 的 流程 实例 。 通 过 formService.submitStartFormData() 方 法 同样 可 以 启动 一 个 新 的 流程 实例 ， 不 过 这 


实例 ) 的 变量 ; #7-E 处 用 来 验证 通过 捕获 “销假 ”用 户 任务 的 输出 流 的 “take” 事 件 执行 的 表达 式 “${execution.setVariable( result ， 


示 流 程 正常 结束 。 


”开头 的 是 普通 变量 。 细 心 的 读者 可 能 发 现 了 一 个 问题 ， 同 样 的 一 个 
量 名 称 保存 该 变量 到 数据 库 ， 当 然 前 提 是 
而 以 “varaible” 开头 的 变量 “startDate” 的 值 为 


审核 节点 均 通 


字段 设置 了 “required” 属 性 并 人 在 变量 中 未 找到 和 表单 字段 相同 的 1D 或 值 为 空 ， 则 抛 


Uy" 


(java.lang.String) ， 因 为 表单 的 内 容 都 是 字符 型 


O 


过 申请 。 


功能 和 taskService.complete() 类 似 ， 对 表单 字段 的 处 理 和 formService.submitStartFormData0 方 法 一 样 。 


‘ok”) 的 


A 


变量 输出 了 两 次 ， 这 是 为 什么 呢 ?” 因 为 在 保存 表单 字段 的 


设置 引擎 的 “history” 属 性 为 “full” 级别 。 正 因 如 此 ， 在 上 面 的 输出 结果 中 ， 以 “form field” 开 头 的 变 


外 注意 Activiti 的 history 默 认 级 别 为 audit， 要 保存 流程 中 产生 的 变量 需要 设置 引擎 的 history 为 fa]]。 
在 本 书 配套 资源 文件 中 ， 源 码 目录 的 LeaveDynamicFormTest 类 中 还 有 一 个 模拟 领导 审批 节点 被 驳回 的 例子 ， 申 请 人 在 “调整 申请 ”节点 选择 了 “取消 申请 ” ， 最 后 变量 “result” 的 值 


为 “canceled” 。 


6.1.3 在 Activiti Explorer 中 运行 流程 
通过 单元 测试 模拟 请 假 流程 的 执行 可 能 比较 抽象 ， 在 第 2 章 中 介绍 了 Activiti 提 供 的 Demo 程 序 一 一 Activiti Explorer， 本 节 将 动态 表单 的 请 假 流 程 部 署 到 Activiti Explorer 中 运行 ， 体 验 一 下 Web 界 面 的 
流程 驱动 。Activiti Explorer 的 使 用 教程 可 以 参考 2.4.2 节 。 


首先 把 请 假 流程 的 xml 和 png 文 件 打包 为 一 个 zip 文 件 ， 图 6-2 展 示 了 打包 的 请 假 流程 的 资源 文件 。 


Today 8:06 PM 


| leave.png Today 8:06 PM 
与 | leave-dynamic-form.zip Today 9:43 PM 


图 6-2 请假 流程 (动态 表单 ) 打包 结果 
在 部 署 “leave-dynamic-form.zip” 文 件 之 后 ， 在 部 署 列 表 可 以 看 到 如 图 6-3 所 示 的 列表 。 


4?ActivitiExplorer La sd 


Database Deployments Jobs Users Groups 


‘Demo processes 
: leave-dynamic-form.ziIp 
lm 心 ) Deployed moments ago 


站 leave-dynamic-form.zip 


Process Definitions 


Resources 


leave.bpmn 


图 6-3 已 部 署 的 请 假 流 程 (动态 表单 ) 


然后 单 击 “Processes” 一 “Deployed process definitions” 看 到 如 图 6-4 所 示 的 请 假 流 程 的 信息 。 


加 fi 


4 Karmit Tha Frog = 
heparts Manage 


| My instances & Deployed process definitions “Model workspace Stad process | Convertto editable model 


请 假 流程 -动态 表单 
Fix Systlem failure 门 wersion 1 EE Deployed moments ago 


Hlp desk Pradess 


Review sales lead Process Diagram 


Simpls aporoval process 


| 洛 Vacalicn reduUest leawe:i:1606 


| 二 放 计 生动 志 表 单 


总 
[3 时 部门 领导 审批- 


图 6-4 已 部 署 的 请 假 流 程 (动态 表单 ) 


要 启动 请 假 流程 只 要 单 击 图 6-4 右 上 角 的 “Start process” 按 钮 即 可 ， 显 示 的 界面 如 图 6-5 所 示 的 流程 启动 界面 。 然 后 单 击 在 “Processes” 一 “My instances” 菜 单 可 以 看 到 正在 运行 的 请 假 流 程 ， 如 
图 6-6 所 示 ， 其 中 以 加 粗 边 框 表 示 当 前 节点 。 同 时 在 流程 图 下 方 还 有 任务 和 变量 列表 ， 如 图 6-7 所 示 ， 注 意 变 量 “applyUserld” 的 值 为 “kermit” (使 用 kermit 登 录 后 启动 的 流程 ) 。 


让 
门 Wersion 1 G) Deployed 5 minutes ago 


请 假 开始 目 期 * ,2012-11-26 


请 假 结 束 日 期 ” |2012-11-28 


请 假 原因 * 


| 


Start process 


图 6-5 ”启动 请 假 流 程 的 界面 


Co ActivitiExplorer ~ 


My instances Deployed process definitions Model workspace 


变 交 请假 流程 -动态 表单 (133) 


图 6-6 ”运行 中 的 请 假 流程 实例 
Tasks 


NAME AS3SSIGNEE CREATED | COMPLETED 


部 门 领导 审批 moments ago 


Waniables 


| applyWserld kermit 
endDate Wed Nov 28 00:00:00 GST 2012 


reason 公休 


startDate Mon Nov 26 00:00:00 GST1 2012 


图 6-7 ”流程 实例 的 任务 列表 和 变量 列表 


接 下 来 就 需要 处 理 任务 了 ， 但 是 从 图 6-8 可 以 看 出 ， 所 有 的 统计 数字 均 为 0， 没 有 任务 需要 办 理 。 部 门 领 导 的 用 户 任务 分 配给 了 角色 “deptLeader”， 所 以 要 想 让 kermit 可 以 处 理 “ 部 门 领 导 审 批 ” 任 务 
需要 向 kermit 授 予 ID 为 “deptLeader” 的 角色 。 


© ActivitiExplorer 


Inbox 加 MyTasks @ Queued @ lnvolved 加 Archived O 


图 6-8 ”kermit 在 没有 被 授予 部 门 经 理 角 色 时 没有 任务 可 以 办 理 


要 授予 用 户 kermit 角 色 需 要 单 击 菜单 “Manage” 一 “Groups”， 然 后 单 击 右上 角 的 “Create group” 按 钮 ， 添 加 如 图 6-9 和 图 6-10 所 示 的 两 个 角色 。 


人 部 门 经 理 


Details 


Id: deptLeader ( Editdetalls ) 
Name: 部 门 经 理 (Dstts eee) 


Type: assignment 


Members 


' EMAIL 


kermiti@activiti.org 


图 6-9 添加 角色 “部 门 经 理 ” 并 把 用 户 kermit 加 入 到 角色 中 


把 角色 “部 门 经 理 ” 和 “人 事 经 理 ” 授 予 kermit 之 后 ， 单 击 菜单 “Tasks” 可 以 看 到 “Queued” 菜 单项 显示 为 “Queued 1”， 如 图 6-11 所 示 。 


全 人 事 经 理 


Details 


ld: hr 


Name: 人事 经 理 


Type: assignment 


EMAIL 


kermit@activiti,org 


图 6-10 添加 角色 “人 事 经 理 ” 并 把 用 户 kermit 加 入 到 角色 中 


图 6-11 ”部门 经 理 有 一 个 待 办 任务 
单 击 图 6-11 的 “部 门 经 理 (1) ”之 后 可 以 看 到 如 图 6-12 所 示 的 任务 办 理 界面 ， 在 此 界面 可 以 签收 (Claim) 任务 、 完 成 任务 ， 当 然 在 完成 任务 之 前 需要 填写 表单 信息 。 


接着 单 击 按钮 “Claim” 签 收 任务 (此 时 其 他 拥有 deptLeader 角 色 的 人 员 就 没有 签收 此 任务 的 权限 了 ) ， 执 行 签收 任务 之 后 “审批 意见 ”字段 可 以 编辑 了 ， 选 择 “ 同 意 “ 选 项 ” (如 图 6-12 所 示 ) ， 然 
后 单 击 按钮 “Complete task” 完 成 任务 办 理 。 


汉 部 门 领导 审批 


No due date 三 Medium Priority © Created 16 minutes ago 


| Clalm | This task has no description Set. 


és No owner (_ Tranafer | és No assignee ( Reassign | 


Subtasks 
No subtasks defined for tis task 


Related content 
No raelated content attached for this task 


Filll In the form below and complete the task: 


图 6-12 ”请 假 流程 的 “部 门 领导 审批 ”任务 办 理 界 面 


此 时 ， 因 为 kermit 用 户 拥有 角色 “人 事 经 理 ”， 所 以 刷新 页 面 后 可 以 看 到 “Queued” 中 的 “人 事 经 理 ” 项 显示 为 1， 如 图 6-14 所 示 。 单 击 “ 人 事 经 理 (1) ”后 显示 如 图 6-15 所 示 的 界面 ， 和 图 6-13 大 
致 类 似 。 


Related content 
No related content attachyed for this task 


Fl In the form below and complete the task: 


Gomplete task | Reset form 


图 6-13 ”在 签收 任务 之 后 选择 审批 意见 为 “同意 ” 


人 事 审批 


No due date 二 Medium Priority 6) Created 2 minutes ago 


Clalm ] This task has no description set, 


Part of procGess: 1 


People 


6 No owner ( Transfer | 


Subtasks 


No subtasks defined for this task 


as No assignee ( Reassign ) 


Related content 


No related content attached for ths task 


图 6-15 ”请 假 流 程 的 “人 事 审批 ”任务 办 理 界 面 


和 处 理 “ 部 门 领导 审批 ”任务 一 样 ， 选 择 “ 审 批 意见 ”字段 的 值 为 “同意 ”并 点 击 按钮 “Complete task” 完 成 任务 办 理 。 


此 时 再 查看 图 6-7 的 界面 会 发 现 多 了 两 个 变量 ， 分 别 是 部 门 领导 和 人 事 经 理 对 申请 做 出 的 处 理 结果 ， 如 图 6-16 所 示 。 


部 门 领导 审批 


销假 


Wanables 


applyUserld 

deptLeaderApproved 

endDate Wed Nov 28 00:00:00 CST 2012 
hrApproved true 

raeason 公休 


startDate Meon Nov 26 O00000 Gel 2012 


图 6-16 ”人 事 审批 任务 办 理 完成 后 查看 运行 中 流程 实例 的 任务 和 变量 列表 


人 事 经 理 完成 任务 之 后 根据 流程 图 的 设计 应 该 流转 到 “销假 ”节点 ， 所 以 此 时 “Inbox” 菜单 显示 为 一 个 待 办 任务 ， 如 图 6-17 所 示 。 


图 6-17 ”人事 经 理 办 理 完 任务 后 kermit 有 一 个 待 办 任务 “销假 ” 


单 击 图 6-17 的 “销假 ”任务 即 可 办 理 任务 ， 如 图 6-18 所 示 。 从 图 6-18 可 以 看 出 “销假 日 期 ”默认 为 请 假 结 束 日 期 ， 因 为 在 流程 定义 中 设置 了 “销假 日 期 ”字段 的 default 属 性 为 “${endDate}”。 单 
击 “Complete task” 完 成 任务 办 理 ， 至 此 流程 实例 结束 。 


假 


No due date 三 Medium Priority @) Created moments ago 


This task has no description set. 


| No owner ( Transfer ) 


Subtasks 
No subtasks defined for this task 


Related content 


No related content attached for this task 


Flll in the form below and complete the task.: 


图 6-18 ”请 假 流程 的 “销假 ”用 户 任务 
人 @@ 记 示 读者 在 执行 过 程 中 可 以 随时 查看 “Manage” 一 “Database” 中 的 Activiti 数据库 表 ， 这 样 能 够 方便 地 了 解 在 执行 菜 个 操作 后 数据 库 会 有 哪些 变化 ， 以 便 更 好 地 理解 执行 过 程 。 


流程 的 “调整 申请 ”用 户 任 务 在 “部 门 领导 审批 ”或 者 “人 事 审批 ”选择 “拒绝 ”之 后 会 被 创建 ， 和 销假 一 样 会 把 用 户 任务 自动 分 配给 申请 人 ， 可 以 自行 模拟 一 次 被 拒绝 的 情况 ， 然 后 在 “调整 申 
请 ”节点 调整 后 再 向 部 门 经 理 提交 申请 。 


6.2 ”实现 自己 的 Activiti Explorer 

Activiti Explorer 是 Activiti 提 供 的 一 个 简易 的 Demo 程 序 ， 在 6.1.3 节 使 用 Activiti Explorer 部 署 了 动态 表单 的 请 假 流程 定义 并 顺利 完成 了 流程 实例 的 执行 。 本 章 主 要 介绍 如 何 运用 动态 表单 和 外 置 表单 ， 
而 6.1.3 节 仅仅 告诉 读者 如 何 使 用 Activiti Explorer 对 动态 表单 的 支持 ， 那 么 Activiti Exploer 具 体 是 如 何 实现 的 呢 ? 本 节 将 一 探究 竟 。 

这 里 明确 一 下 实际 需求 ， 重 新 设计 的 Activiti Explorer 的 目的 有 以 下 几 点 : 

. 学 习 如 何 根据 用 户 任务 的 表单 字段 动态 生成 表单 。 

弥补 官方 的 Activiti Explorer 不 支持 外 置 (FormKey) 表单 的 缺陷 。 


作为 后 续 章节 学 习 的 一 个 基础 组 件 。 
6.2.1 ”完善 身份 验证 功能 


为 了 模拟 一 个 真实 的 系统 功能 ， 在 第 5 章 的 基础 上 添加 了 登录 和 退出 功能 ， 如 图 6-19 和 6-20 所 示 ， 在 图 6-19 中 输入 用 户 名 和 密码 之 后 单 击 “ 登 录 系统 ”按钮 后 打开 如 图 6-20 所 示 的 页 面 ， 可 以 单 击 右 上 
角 的 下 拉 框 ， 然 后 单 击 “安全 退出 ”切换 用 户 。 


第 6 章 一 任务 表单 配 


henry 


图 6-19 ”登录 页 面 


Activiti Explorer 首页 器 管 理 ~ 里 Henry Yanmenry~ 


本 章 主要 讲解 : 业务 结合 流程 以 及 多 种 表单 的 使 用 (formkay 方 式 、 动 态 表单 、 自 定义 表单 ) 


站 收 改 密码 


图 6-20 ”系统 首页 
本 章 内 容 的 源码 位 于 本 书 配套 资源 文件 的 “chapter6-oa-forms” 文件 夹 中 ， 可 以 导入 到 Eclipse 或 其 他 IDE 中 运行 、 查 看 。 
请 假 流 程 涉及 多 个 角色 (Activiti 中 称 之 为 “组 ”， 即 Group) ， 这 里 假定 有 如 下 几 个 : 
: 总 经 理 
. 部 门 领导 
" 人 事 经 理 
同时 涉及 技术 部 、 人 事 部 、 业 务 部 、 和 总 经 理 室 三 个 部 门 。 表 6-2 列 出 了 每 个 用 户 的 所 属 部 门 及 拥有 的 角色 。 


表 6-2 每 个 用 户 所 属 部 门 及 拥有 的 角色 


a 业务 部 部 门 经 理 
bi 总 经 理 室 总 经 理 
henry Henry Yan 系统 管理 员 


在 启动 应 用 (在 终端 中 输入 mvn jetty:run 命 令 回 车 ) 之 前 需要 先 初始 化 数据 库 ， 把 表 6-2 中 的 用 户 及 角色 数据 插入 到 Activiti 数 据 库 中 ， 此 操作 通过 Maven 的 antrunl1] 插 件 执行 : 


mvn antrun:run -Pinit-db 


其 中 的 init-db 是 在 pom.xml 中 定义 的 一 个 Profile 咎 ， 在 此 Profle 中 定义 了 初始 化 的 操作 ， 使 用 DbunitB] 工 具 把 “chapter6-oa-forms/src/main/resources/datayidentity-data.xml” 中 的 数据 通过 
JDBC 方 式 插入 到 | 数据 库 中 。 


为 了 让 我 们 的 Activiti Explorer 看 起 来 接近 实际 的 企业 应 用 ， 利 用 Bootstrap 框 架设 计 了 一 个 比较 简洁 的 页 面 框架 ， 并 借用 第 5 章 实现 的 流程 定义 列表 作为 本 章 内 容 的 实现 基础 ， 图 6-21 为 整合 后 的 界 


辆 Activixi Explorer[ 第 6 章 -任务 


人 外 localhost:8080/chapter6-0a-forms/main/index# 


Activiti Explorer “会 首页 


部 署 流程 资产 


Nofile chosen Submit 


| Choose File 


流程 定义 1D 部 署 ID 流程 定义 名 称 流程 定义 KEY 版 本 号 XML 资源 名 称 图 片 资源 名 称 


leave:1:108 105 请 假 流程 -动态 表单 leave 1 leave.bpmn leave.png 


图 6-21 添加 了 下 拉 菜 单 的 Activit Explorer 


6.2.2 ”流程 启动 表单 


图 6-21 的 列表 中 添加 了 一 个 “启动 ”按钮 用 来 启动 一 个 流程 实例 。 在 官方 的 Activiti Explorer 中 启动 流程 实例 是 从 已 部 署 的 流程 定义 列表 中 选择 一 个 流程 定义 ， 然 后 单 击 “Start process” 按 钮 ， 页 面 刷 
新 后 会 显示 流程 的 空 启动 事件 定义 的 表单 字段 ， 所 以 我 们 第 一 步 要 做 的 就 是 读 取 流程 启动 事件 的 表单 。 


1. 读 取 流 程 启动 表单 


单 击 图 6-21 中 列表 的 “启动 ”按钮 即 可 读 取 空 启动 事件 的 表单 字段 ， 如 图 6-22 所 示 。 然 后 单 击 “启动 流程 ”按钮 。 


Activiti Explorer 会 首页 管理 ~ 


一 请 假 流 


请 假 开始 日 期 : | 2012-11-08 


请 假 结 束 日 期 2012-11-=15 


请假 原因 ， 


图 6-22 ”启动 流程 填写 表单 
看 似 简单 的 两 步 操作 ， 代 码 是 如 何 实现 的 呢 ? 为 了 实现 这 两 步 ， 我 们 定义 了 一 个 类 “Process-DefinitionController” 负责 接收 并 处 理 请 求 ， 其 中 有 两 个 方法 分 别 负责 读 取 启动 流程 的 表单 和 启动 流程 。 


图 6-21 中 的 “启动 ”按钮 的 功能 实际 是 跳 转 到 一 个 链接 ， 代 码 如 下 : 


<a href='${ctx }/chapter6/getform/start/${pd.id }'> 启 动 </a> 


其 中 的 “$fpd.id}y” 即 第 5 章 的 流程 定义 列表 中 流程 定义 对 象 的 D， 本 章 的 例子 只 是 基于 第 5 章 的 列表 进行 了 扩展 而 已 。 
代码 清单 6-7 展 示 了 “启动 ”按钮 对 应 的 后 台 处 理 代码 。 


代码 清单 6-7” 读 取 启动 流程 表单 


@Controller 

QRequestMapping (value = "/chapter6") #1 

public class ProcessDefinitionController extends AbstractController { 
// 读 取 启 动 流 程 的 表单 字段 
@QRequestMapping (value = "getform/start/{processDefinitionId}") #2 
// processDefinitionId 参 数 对 应 链接 的 最 后 一 个 参数 
public ModelAndView readStartForm( 


QPathVariable ("processDefinitionId") String processDefinitionId) throws Exception { 

String viewName = "chapter6/start-process-form"; // 位 于 WEB-INF/views 目 录 

ModelAndView mav = new ModelAndView (viewName) ， 

StartFormData startFormData = formService.getStartFormData (processDefinitionId); #3 
mav.addobject ("startFormData", startFormData); #4-S 

mav.addobject ("processDefinitionId", processDefinitionId); #4-E 


return mav; 


首先 说 明 一 下 本 章 所 有 新 增 的 类 访问 路 径 均 以 “/chapter6” 开 头 ， 例 如 代码 清单 6-7 的 #1 处 。 
#2 处 声明 readStartForm() 方 法 的 访问 路 径 为 “getform/start/{processDefinitionld}”。 


#3 处 是 代码 清单 6-7 的 重点 ， 通 过 getStartFormData() 方 法 即 可 读 取 启动 流程 时 需要 填写 的 表单 数据 (设计 流程 定义 时 定义 的 字段 集合 ) ， 得 到 一 个 startFormData 对 象 ， 还 可 以 获取 表单 字段 对 象 集 
合 ， 并 且 可 以 读 取 表 6-1 中 的 所 有 属性 值 。 


#4 处 把 需要 的 对 象 设 置 到 ModelAndView 对 象 中 ， 以 便 在 展示 层 可 以 利用 。 
有 了 读 取 表单 内 容 的 功能 支持 就 可 以 编写 对 应 的 展示 层 了 。 依 然 使 用 JSP 作 为 展示 层 的 实现 ， 功 能 就 是 解析 表单 数据 把 不 同 的 字段 类 型 转换 为 HTML 代 码 (图 6-22 中 的 三 个 输入 框 ; 笔者 使 用 了 Twitter 
的 Bootstrap 办 作为 CSS 基 础 框架 来 演 染 页 面 元 素 ) 。 


代码 清单 6-8 列 出 了 图 6-22 的 JSP 实 现代 码 ， 读 者 可 以 在 本 书 配套 资源 文件 的 chapter6-oa-forms/src/main/webapp/WEB-INF/views/chapter6 目 录 中 找到 JSP 文 件 “start-process-form.jsp”。 


代码 清单 6-8 ”根据 StartFormData 对 象 转换 为 HTML 元 素 


<form method="post" 
action="${ctx }/chapter6/process-instance/start/$ {processDefinitionId}"> #1 
<c:forEach items="${startFormData.formProperties}" var="fp"> 


<c:set var="fpo" value="${fp}"/> // 把 ${fp} 存 放 到 pageContext 对 象 的 属性 中 

<%$ // 把 需要 获取 的 属性 读 取 并 设置 到 pageContext 域 

// 要 获取 日 期 字段 设置 的 格式 需要 调用 org.activiti.engine.impl. form. AbstractFormType 类 的 

// getInformation() 方 法 ， 但 是 EL 不 支持 直接 调用 方法 ， 所 以 不 得 不 转化 
FormType type = ((FormProperty)pageContext .getAttribute ("fpo")) .getType () ， 
String[] keys = {"datePattern"}; // 定义 需要 读 取 的 其 他 扩展 属性 的 名 称 

for (String key: keys) { 

pageContext .setAttribute (key, ObjectUtils.toString (type.getInformation 


(key) ) ); #2 
} %> 
<%-- 文本 或 者 数字 类 型 --%> 
<c:if test="${fp.type.name == 'string' || fp.type.name == 'long'}"> #3-S 
<label for="${fp.id}">$ {fp.name}:</label> 
<input type="text" igd="${fp.id}" name="${fp.id}" /> 
去 /GE #3-E 
<c:if test="${fp.type.name == 'date'}"> <$%-- 日 期 --%> 
<label for="${fp.id}">${fp.name}:</label> 
<input type="text" id="${fp.id}" name="${fp.id}" class="datepicker" 
data-date-format="$ {fn:toLowerCase (datePattern) }" /> #4 
</c:if> 
</c:forEach> 
<button type="submit" class="btn"><i class="icon-play"></i> 启 动 流程 </button> #5 


</form> 


代码 清单 6-8 用 JSP 和 HTML 代 码 联合 起 来 完成 解析 表单 字段 的 功能 ，#1 处 指定 了 表单 的 action 属 性 ， 即 单 击 了 #5 处 的 “启动 流程 ”按钮 后 请 求 的 URL。 


在 #2 处 从 类 FormType 的 对 象 type 中 读 取 字段 的 扩展 属性 (只 有 所 有 字段 共有 的 字段 才能 通过 getXxx() 方 法 获取 ， 所 以 id、name 属 性 可 以 直接 通过 EL 表达 式 获取 ) 并 设置 到 pageContext 的 属性 中 


， 这 
样 在 #4 处 就 可 以 通过 EL 表达 式 的 方式 获取 日 期 类 型 字段 的 日 期 格式 。 
#3 处 用 来 处 理 type 为 string、long 的 字段 ， 这 里 仅 输 出 了 一 个 普通 的 文本 框 组 件 的 HTML 代 码 。 在 #4 处 的 日 期 组 件 也 与 此 类 似 ， 只 不 过 针对 日 期 类 型 添加 了 一 个 属性 “data-date-format” 用 来 保存 日 


期 的 格式 (一 个 基于 Bootstrap 的 日 期 插件 规范 要 求 ) 。 
因此 在 单 击 图 6-21 的 “启动 ”按钮 后 即 可 显示 图 6-22 所 示 的 表单 内 容 。 
2. 启 动 流程 


在 6.1.2 节 的 单元 测试 中 用 runtimesService.startProcesslnstanceByKey() 的 方式 启动 了 流程 ， 将 变量 通过 一 个 Map 对 象 封装 传递 给 方法 。 本 节 的 内 容 是 基于 Web 页 面 的 方式 操作 ， 但 是 万 变 不 离 其 宗 ， 
本 例 同样 也 要 把 表单 的 值 封装 成 一 个 Map 对 象 传递 给 启动 流程 的 方法 。 


图 6-22 的 表单 提交 后 访问 一 个 后 台 的 服务 ， 在 ProcessDefinitionControllerjava 类 中 定义 了 一 个 方法 startProcesslnstance(String processDefinitionld)， 见 代码 清单 6-9。 


代码 清单 6-9 读 取 表 单数 据 并 局 动 流程 实例 


QRequestMapping (value = "Process-instance/start/{ProcessDefinitionIdq}") 
public String startProcess] ee ta ek, 
String processDefinitionId, HttpServletRequest request) { 
// 先 读 取 表单 字段 ， 再 根据 表单 字段 的 ID 读 取 请 求 参数 值 


StartFormData formData = formService .getStartFormData (processDefinitionId) ， #1-S 
// 从 请 求 中 获取 表单 字 段 的 值 

jst<FormProperty> formProperties = formData.getFormProperties () ， #1-1 
Map<String, String> formValues = new HashMap<String, String>(); 

for (FormProperty formProperty : formProperties) { 

String value = request.getParameter (formProperty.getId()); // 从 request 读 取 参 数值 


formValues.put (formProperty.getId()，value); // 把 表单 字段 及 对 应 值 设置 到 Map 对 象 中 
} 
// 获取 当前 登录 的 用 户 


User user = UserUtil.getUserFromSession (request 
identityService.setAuthenticatedUserlId (user.ge 
// 提交 表单 字段 并 启动 一 个 新 的 流程 实例 
Processinstance ProcessInstance = 
formService.submitStartFormData (processDefinitionId, formValues); #2 一 EE 
return “redirect:/chapter5/process-list"; 


getSession () ); #2-S 
[a ()); 


代码 清单 6-9 的 功能 是 读 取 表 单 参数 并 启动 一 个 新 的 流程 实例 ， 分 为 两 个 步骤 
#1 处 为 第 一 个 步骤 ， 读 取 启 动 表单 的 字段 (#1-S 处 ) ， 在 #1-1 处 读 取 表 单字 段 集合 ， 最 后 循环 表单 字段 并 把 请 求 的 表单 字段 值 用 Map 方 式 保存 。 
#2 处 为 第 二 个 步骤 ， 启 动 流程 实例 后 返回 流程 定义 列表 。 


6.2.3 ”任务 签收 与 办 理 


如 何 读 取 任 务 在 前 面 的 章节 中 已 经 多 次 涉及 ， 现 在 需要 使 用 Web 方 式 读 取 待 办 任务 。 待 办 任务 的 数据 来 源 有 以 下 4 类 。 
第 一 种 是 直接 分 配 : 直接 通过 humanPetformet 元 素 或 activiti:assignee 属 性 指定 某 个 人 的 ID 作为 任务 办 理 人 。 

. 第 二 种 是 在 候选 人 范围 之 内 。 

* 第 三 种 是 属于 某 个 候选 组 


* 第 四 种 是 代办 的 任务 : 这 类 任务 的 来 源 相 对 来 说 比较 特殊 。 我 们 用 模拟 场景 的 方式 说 明 这 一 概念 : 有 一 个 属于 用 户 A 的 任务 ，A 把 任务 交 给 用 户 B 办 理 〈 此 时 B 是 办 理 人 ，A 是 任务 所 有 人 


(Ownet) ) ，B 办 理 完 之 后 又 将 任务 回归 到 A， 这 个 过 程 就 称 为 代办 (在 第 11 章 中 将 详细 讲解 ) 。 这 种 功能 常用 于 上 级 的 任务 交 给 下 级 代办 ， 或 者 当 某 个 用 户 因为 其 他 原因 没 时 间 处 理 任 务 时 将 其 交 由 其 他 
人 代办 。 


和 任务 相关 的 另外 一 个 概念 “ 转 办 ”， 读 者 也 需要 了 解 : 把 一 个 任务 的 办 理 人 重新 分 配给 其 他 的 用 户 的 过 程 称 为 转 办 。 


一 个 简单 的 任务 列表 包含 任务 对 象 的 几 个 属性 ， 如 图 6-23 所 示 。 


任务 1D 任务 名 称 流程 实例 ID 任务 创建 时 间 


215 部 门 领导 审批 205 Tue Nov 27 22:41:46 GST 2012 


图 6-23 ”一 个 简单 的 任务 列表 


在 启动 了 流程 之 后 如 果 在 任务 列表 没有 任务 要 退出 ， 则 使 用 “kermit” 用 户 登录 ， 因 为 “部 门 领导 审批 ”任务 需要 具有 部 门 领导 角色 的 用 户 才 有 权限 签收 与 办 理 。 
负责 任务 相关 功能 的 控制 器 类 名 为 TaskController， 其 中 的 todoTasks0) 方 法 负责 读 取 任务 列表 。 代 码 清单 6-10 列 出 了 实现 读 取 待 办 任务 列表 的 todoTasks0 的 代码 片段 。 


代码 清单 6-10 ” 读 取 待 办 任务 列表 的 代码 片段 


ModelAndView mav = new ModelAndView (viewName) ， 

User user = UserUtil.getUserFromSession (session); 

/ 读 取 直 接 分 配给 当前 人 或 者 已 经 签收 的 任务 

List<Task> doingTasks = taskService.createTaskQuery() .taskAssignee (user.getId()) .list(); #1 

// 等 待 签收 的 任务 

List<Task> waitingClaimTasks = taskService.createTaskQuery() // TaskQuery 对 象 
.taskCandidateUser (user.getId()) .list(); #2 

// 合并 两 种 任务 


List<Task> allTasks = new ArrayList<Task> (); 
allTasks.adgdAll (doingTasks); 
allTasks.adgdAll (waitingClaimTasks); 
mav.addobject ("tasks", allTasks); 


代码 清单 6-10 的 #2 处 需要 特别 说 明 一 下 : taskCandidateUser(user.getld0) 方 法 读 取 的 任务 列表 是 待 办 任务 数据 来 源 的 前 两 种 的 并 集 。 

在 调用 TaskQuery 对 象 的 taskCandidateUser() 方 法 后 查询 结果 包含 任务 数据 来 源 的 第 二 种 和 第 三 种 情况 ， 首 先 查 询 直 接 用 activiti:cadidateUser 指 定 的 用 户 集合 ， 其 次 查询 activiti:cadidateGroups 属 
性 指定 组 ， 在 查询 组 时 会 根据 用 户 与 组 的 关系 联合 查询 。 

在 Activiti 5.16 版 本 中 添加 了 一 个 专门 用 来 查询 这 两 种 任务 集合 的 过 滤器 ， 名 称 为 taskCandidateOrAssigned (userld) ， 在 Activiti 5.16 之 后 的 版 本 中 使 用 该 过 滤器 可 以 简化 待 办 任务 的 查询 方式 。 代 
码 清单 6-10 中 查询 待 办 任务 的 代码 块 可 以 用 下 面 的 一 行 代 码 取 代 : 


List<Task> tasks = taskService.createTaskQuery () 
.taskCandidateOrAssigned (user.getId()).1ist(); 


图 6-23 的 列表 是 根据 代码 清单 6-10 的 任务 集合 循环 输出 的 。 代 码 清单 6-11 列 出 了 输出 列表 的 部 分 EL 表达 式 代码 。 


代码 清单 6-11 图 6-23 中 列表 的 JSP 代 码 


<ta>$ {task.id }</td> // 可 以 查看 API 获 取 Task 的 更 多 属性 
<td>${task.name }</td> 
<td>${task.processInstancelId }</td> 
< 

< 


td>$ {task.createTime }</td> 
tdq>$ {task.assignee }</tqd> 
<td> // 当 办 理 人 属性 为 空 时 任务 需要 签收 
<c:if test="${empty task.assignee }"><a class="btn" href="claim/${task.id}"> 签 收 </a></c:if 
<c:if test="${not empty task.assignee }"> // 当 办 理 人 属性 不 为 空 时 可 以 办 理 任务 

<a class="btn" href="getform/task/${task.id}"><i class="icon-user"></i> 办 理 </a> 
</Crif></td> 


V 


和 代码 清单 6-6 中 处 理 任务 的 方式 一 样 ， 首 先 需 要 部 门 领导 签收 此 任务 ， 也 就 是 单 击 图 6-23 中 的 “签收 ”按钮 ， 然 后 刷新 页 面 显示 如 图 6-24 所 示 的 列表 ， 原 来 的 “签收 ”按钮 改 成 了 “办 理 ” 按 钮 。 


任务 ID 性 务 名 称 流程 实例 ID 任务 创建 时 间 办 理 人 操作 


215 部 门 领导 审批 205 Tue Nov 27 22:41:46 CST 2012 warmit 量 办 理 


图 6-24 单 击 “ 签 收 ” 按 钮 之 后 显示 “办 理 ” 按 包 


用 户 的 任务 是 和 人 交互 ， 所 以 当 单 击 “ 办 理 ” 按 钮 时 需要 读 取 任务 的 表单 。 读 取 任 务 表单 的 方式 和 读 取 启动 流程 表单 类 似 ， 单 击 “ 办 理 ” 按 钮 后 读 取 的 任务 表单 并 自动 填充 了 申请 人 填写 的 信息 ， 如 图 
6-25 所 不 。 


请 假 开 始 日 期 : 2012=11=28 


请 假 结束 日 期 : | 2012-11-30 


请 假 原因 : 笃 体 


了 > 完成 任务 


图 6-25 ” 单 击 图 6-24 中 的 “办 理 ” 按 钮 后 显示 的 任务 办 理 页 面 
代码 清单 6-12 列 出 了 读 取 任 务 表单 的 Java 代 码 ， 和 读 取 启动 流程 的 表单 类 似 。 


代码 清单 6-12 ” 读 取 用 户 任 务 表单 


QRequestMapping (value = "task/getform/{taskId}") 

public ModelAndView readTaskForm(@PathVariable ("taskId") String taskId) throws Exception { 
ModelAndView mav = new ModelAndView ("chapter6/task-form"); 
TaskFormData taskFormData = formService.getTaskFormData (task1d); #1 
mav.addobject ("taskFormData", taskFormData); 
return mav; 


} 


代码 清单 6-12 通 过 formservice.getTaskFormData() 方 法 读 取 一 个 任务 的 表单 对 象 ， 然 后 把 表单 数据 交 给 视图 “chapter6/task-form” 处 理 ， 即 得 到 了 如 图 6-25 所 示 的 页 面 。 其 中 “WEB- 
INF/views/chapter6/task-form.jsp” 和 代码 清单 6-8 类 似 ， 故 不 再 列 出 ， 读 者 可 以 打开 源码 查看 如 何 根据 表单 字段 的 属性 设置 HTML 元 素 的 属性 。 


图 6-25 方 框 中 的 三 个 字段 是 灰色 的 ， 表 示 只 读 ， 只 有 “审批 意见 ”字段 可 以 编辑 ， 单 击 按钮 “完成 任务 ”提交 完成 任务 请 求 。 查 看 图 6-25 的 页 面 源码 可 以 看 到 表单 的 实际 路 径 如 下 : 


<form action="/chapter6-o0a-forms/chapter6/task/complete/451" method="post"> 


其 中 form 的 action 属 性 中 的 “451” 是 用 户 任务 “部 门 领导 审批 ”的 1D， 对 应 的 后 台 处 理 代 码 见 代码 清单 6-13。 


代码 清单 6-13 ” 读 取 完成 任务 的 表单 值 并 完成 任务 


QRequestMapping (value = "task/complete/{taskId}") 
public String completeTask (GPathVariable ("taskId") String taskId, HttpServiletRequest request) throws Exception { 
TaskFormData taskFormData = formService.getTaskFormData (task1d); #1 


// 从 请 求 中 获取 表单 字段 的 值 
List<FormProperty> formProperties = taskFormData.getFormPproperties (); 
Map<String, String> formValues = new HashMap<Sst 0 String> (); 

for (FormProperty formProperty : formProperties) 

fy fy) 1 拓 隐 当前 能 务 表单 中 不 可 写 的 字段 要 
String value = request.getParameter (formProperty.getId()); 
formValues.put (formProperty.getId(), value); 


} 
} / 提交 用 户 任务 表单 并 完成 任务 
CR ww formValues); #3 
return TASK LIST; 


代码 清单 6-13 中 的 实现 方式 和 启动 流程 类 似 ， 在 #1 处 首先 读 取 任 务 表单 ， 然 后 从 request 对 象 中 获取 表单 字段 的 值 。 
#2 处 是 新 添加 的 代码 ， 用 来 排除 当前 任务 表单 中 不 可 写 的 字段 。 如 果 不 排除 不 可 写 的 字段 而 在 formValue 变 量 中 添加 了 属性 ， 那 么 Activiti 会 抛 出 异常 提示 字段 不 可 写 。 


单 击 了 图 6-25 的 “完成 任务 ”按钮 后 切换 用 户 “jenny” 可 以 看 到 如 图 6-26 所 示 的 任务 列表 ， 有 一 条 “人 事 审批 ”的 任务 等 待 签收 。 


流程 中 剩余 的 其 他 任务 不 再 一 一 列举 ， 读 者 可 以 选择 不 同 的 审批 意见 来 模拟 不 同 的 处 理 情 况 。 


任 才 ID 任务 名 称 ”流程 实例 ID 任务 创建 时 间 办 理 人 操作 


470 人 事 审批 441 Wed Nov 28 01:21:06 CST 2012 全 短路 


图 6-26 ”任务 “人 事 审 批 ” 等 待 办 理 
6.2.4” 自 定义 表单 的 字段 类 型 


需要 为 动态 表单 的 每 个 字段 指定 一 个 类 型 ， 目 前 Activiti 默 认 支 持 的 类 型 有 string、long、enum、date、boolean、collection。 在 实际 的 应 用 中 ， 如 果 需 要 其 他 类 型 的 字段 该 如 何 处 理 呢 ? 很 幸 
运 ，Activiti 允 许 自 定义 表单 字段 类 型 ， 比 如 执行 一 段 Javascript 脚 本 。 


在 启动 流程 的 表单 中 添加 一 段 Javascript 代 码 ， 用 于 提示 表单 加 载 完 毕 。 为 了 演示 如 何 自 定义 表单 字段 ， 在 原来 的 请 假 流 程 基础 上 进行 了 更 改 ， 又 重新 部 署 了 一 个 版 本 号 为 2 (如 果 流 程 I1D 相 同 ， 引 警 会 
自动 累加 版 本 号 ) 的 请 假 流程 ， 如 图 6-27 所 示 。 


流程 定义 ID 部 嗜 ID 流程 定义 名 称 流程 定 光 KEY 


leave:1:204 201 请 假 流 香 - 动 态 表单 |eawe 


laave:2:604 请 假 流程 -动态 表单 


图 6-27 ”部署 版 本 号 为 2 的 请 假 流 程 
首先 需要 在 空 启动 事件 的 表单 最 后 (只 有 在 其 他 的 HTML 元 素 都 泻 染 完 之 后 执行 脚本 才 符 合 逻 辑 ) 添加 自 定义 的 表单 字段 。 代 码 清单 6-14 列 出 了 自 定义 的 Javascript 表 单字 段 。 


代码 清单 6-14” 自 定义 的 Javascript 表 单字 段 


<startEvent id="starteventl" name="Start" activiti:initiator="applyUserId"> 
<extensionElements> 
<activiti:formPproperty id="validScript" type="javascript" #1 
default="alert (' 表 单 已 经 加 载 完 毕 ') ; "> 2 
</activiti:formPproperty> 
</extensionElements> 
</startEvent> 


代码 清单 6-14 的 #1 处 设置 了 属性 “type” 为 javascript”，#2 处 的 “default” 属 性 设置 了 一 段 Javascript 肢 本。 读者 可 能 会 问 : 为 什么 使 用 default 属 性 而 不 是 value? 当 读 取 启 动 表单 字段 时 ， 还 未 
启动 流程 引 警 会 使 用 default 属 性 作为 value 属 性 的 值 ， 所 以 在 代码 清单 6-15 中 使 用 “${fp.value}” 读 取 Javascript 表 单字 段 的 脚本 内 容 。 


代码 清单 6-15” 读 取 自 定义 的 Javascript 表 单字 段 


<c:if test="${fp.type.name == 'javascript'}"> 
<script type="text/javascript">${fp.value};</script> 
< GE 


在 流程 定义 文件 中 定义 了 自 定 义 的 表单 字段 后 ， 还 需要 让 引 警 加载 自 定义 表单 解析 类 ， 用 来 转换 表单 值 ， 所 有 自 定 义 的 表单 字段 需要 继承 一 个 表达 类 型 抽象 
“org.activiti.engine.impl.form.AbstractFormType”。Javascript 表 单字 段 的 类 JavascriptFormType 如 代码 清单 6-16 所 示 。 


状 


代码 清单 6-16 ”用 于 转换 Javascript 表 单字 段 的 类 


public class JavascriptFormType extends AbstractFormType { 


QOverride 

public String getName () { . | 
return "javascript"; // 和 流程 定义 文件 的 type 字 段 匹 配 #1 

} 

QOverride 

public Object convertFormValueToModelValue (String propertyValue) 1 #2 
return propertyValue; // 把 表单 填写 的 内 容 转换 为 Java 的 对 象 类 型 

} 

QOverride 

public String convertModelValueToFormValue (Object modelValue) { #3 
return (String) modelValue; // 把 Java 对 象 类 型 转换 为 字符 型 


} 
} 


代码 清单 6-16 展 示 了 一 个 标准 的 表单 字段 类 型 的 转换 类 ， 首 先 在 #1 处 的 getrName00 方 法 中 设置 唯一 的 表单 字段 类 型 标示 符 ， 在 #2 和 #3 处 分 别处 理 字 符 型 与 Java 对 象 类 型 的 互相 转换 。 本 例 的 Javascript 
是 纯 文本 ， 所 以 不 需要 做 其 他 特殊 处 理 ， 但 是 对 于 日 期 类 型 的 字段 就 需要 使 用 日 期 格式 化 类 进行 互相 转换 ， 读 者 可 以 参考 引擎 源码 的 日 期 表单 字段 类 型 的 


类 “org.activiti.engine.impl.form.DateFormType”。 
自 定义 的 表单 字段 类 型 需要 在 流程 引擎 中 进行 注册 ， 否 则 引擎 会 提示 未 找到 对 应 的 类 型 转换 类 。 注 册 表 单字 段 类 型 的 配置 如 代码 清单 6-17 所 示 。 


代码 清单 6-17 ”注册 自 定 义 表 单字 段 类 型 


<bean id="processEngineConfiguration" 
class="org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration"> 
<property name="customFormlypes"> 
<l1i8t> 
<bean class="me.kafeitu.activiti.chapter6.form.JavascriptFormType" /> 


</list> 
</property> 
</bean> 


在 代码 清单 6-17 中 通过 引擎 的 属性 “customFormTypes” 设置 了 List 集 合并 添加 了 一 个 Bean 对 象 ， 这 样 在 引擎 运行 过 程 中 遇 到 “javascript” 类 型 的 字段 时 就 会 调用 自 定 义 表单 类 型 进行 类 型 转换 。 


现在 再 次 部 署 流程 定义 “请 假 流程 -动态 表单 ”的 Javascript 版 本 启动 后 就 会 弹出 对 话 框 ， 如 图 6-28 所 示 。 


启动 流程 一 请 假 流程 -动态 表单 ， 版 本 号 : 2 


请 假 开始 日 期 : 


请 假 结束 日 期 : 


The page at localhost:8080 says: 
表单 已 经 加 载 完 上 毕 


图 6-28 表单 演 染 完成 后 执行 Javascript 脚 本 的 效果 
至 此 ， 关 于 应 用 动态 表单 的 内 容 画 上 了 句号 ， 从 6.1 和 6.2 节 中 我 们 学 会 了 如 何 设计 动态 表单 的 定义 ， 如 何 读 取 流 程 启动 表单 并 启动 流程 实例 ， 如 何 读 取 任 务 表单 并 完成 任务 。 


[1] maven-antrun-plugin 允 许 通 过 Maven 执 行 ant 任 务 (target) ， 插 件 主页 : http://maven.apache.org/plugins/maven-antrun-plugin/ 

[2] Profile 是 Maven 的 一 个 独特 功能 。 对 于 一 个 相同 的 项 目 来 说 ， 使 用 不 同 的 Profile 可 以 产生 不 同 的 结果 。 一 般 用 来 区 分 开发 环境 、 生 产 环境 ， 因 为 这 两 个 环境 的 配置 文件 不 同 ( 例 如 数据 库 、 日 志 等 ) ， 在 一 
个 Profile 中 可 以 定义 需要 额外 执行 的 插件 、 命 令 等 。 有 兴趣 的 读者 可 以 参考 许 晓 斌 著 《Maven 实 战 》 的 Profile 章 节 。 

[3] Dbunit 常 用 于 测试 阶段 ， 也 可 以 作为 数据 库 的 转换 工具 使 用 ， 可 以 把 xml 格 式 的 数据 转换 为 ql， 然后 通过 jdbc 持 久 化 到 数据 库 。 官 网 地 址 : http://www.dbunit.org/。 

[和 Bootstrap, 由 Twitter 开 发 的 开源 CSS 框 架 ， 官 网 地 址 : http://twitter.github.com/bootstrap。 


6.3 ”外 置 表单 
动态 表单 在 页 面 上 的 显示 方式 是 逐 行 输出 ， 这 样 在 字段 比较 多 的 情况 下 会 导致 表单 非常 长 ， 用 户 体验 非常 差 ， 而 且 会 浪费 很 多 空间 ( 右 侧 是 空白 的 ) ， 使 页 面 的 显示 非常 死板 单调 。 此 外 ， 如 果 需 要 除 
引擎 默认 支持 的 字段 类 型 之 外 的 字段 ， 还 需要 在 抽象 类 的 基础 上 进行 自行 扩展 。 


动态 表单 的 字段 以 键 值 对 形式 存储 在 引擎 的 变量 表 (ACT_HI_DETAIL) 中 ， 这 对 于 数据 结构 比较 简单 的 业务 来 说 还 能 满足 ， 但 是 对 于 业务 关联 关系 比较 复杂 且 日 后 需要 数据 分 析 的 情况 就 显得 力不从心 
J 


外 置 表单 可 以 很 好 地 解决 动态 表单 的 不 足 ， 因 为 在 流程 运行 时 表单 内 容 (从 部 署 的 表单 文件 中 读 取 ) 会 原样 显示 在 页 面 ， 当 然 同样 支持 动态 表单 的 字段 值 的 自动 填充 功能 。 

因此 ， 根 据 外 置 表单 的 特点 ， 在 实际 应 用 中 大 多 数 应 用 利用 都 是 外 置 表单 ， 流 程 中 的 一 个 或 多 个 用 户 任务 对 应 一 个 表单 文件 (扩展 名 为 .form) 。 还 有 一 部 分 应 用 使 用 的 是 普通 表单 ， 即 把 表单 内 容 直接 
写 在 展示 层 页 面 (例如 Jsp、Jsf、html 等 文件 ) 中 ， 将 在 7.5 节 详细 讲解 。 
6.3.1 流程 定义 

本 节 还 是 以 请 假 流 程 为 例 ， 在 保留 所 有 业务 条 件 的 情况 下 把 表单 字段 元 素 统统 删除 ， 取 而 代 之 的 是 在 启动 事件 和 每 个 用 户 任 务 上 设置 表单 属性 “activiti:formKey” (参考 表 4-1) 。 外 置 表单 版 本 的 请 
假 流程 定义 见 代 码 清单 6-18， 其 中 省 略 了 一 些 输出 流 的 xml， 读 者 可 以 参考 动态 表单 版 本 的 请 假 流 程 定义 。 


代码 清单 6-18 ”外 置 表 版 本 的 请 假 流程 定义 


<process id="leave-formkey" name=" 请 假 流程 -- 外 置 表单 "> 
<startEvent id="starteventl" name="Start" activiti:initiator="applyUserId" 
activiti:formKey="chapter6/leave-formkey/leave-start.form"></startEvent> 
<userTask id="deptLeaderVerify" name=" 部 门 经 理 审批 " 
activiti:candidateGroups="deptLeader" 
activiti:formKey=" chapter6/leave-formkey/ approve.form"/> 
<userTask igd="hrVerify" name=" 人 事 经 理 审 批 " activiti:candidateGroups="hr" 


activiti:formKey=" chapter6/leave-formkey/approve.form"></userTask> 
<userTask id="reportBack" name=" 销 假 " activiti:assignee="${applyUserId}" 
activiti:formKey=" chapter6/leave-formkey/report-back.form"></userTask> 
<userTask id="modifyApply"” name=" 调 整 申请 内 容 " activiti:assignee="${applyUserId}" 
activiti:formKey=" chapter6/leave-formkey/modify-apply.form"></userTask> 
<endEvent id="endeventl" name="End"></endEvent> 
</process> 


DR 


代码 清单 6-18 中 的 空 启动 事件 与 4 个 用 户 任务 均 使 用 属性 activiti:formKey 设 置 表单 名 称 。 值 得 一 提 的 是 activiti:formKey 属 性 支持 动态 设置 (即使 用 变量 方式 设置 ) ， 例 如 
activiti:formKey="${fooFormName}.form"， 在 任务 启动 或 完成 时 通过 变量 设置 fooFormName 即 可 动态 设置 表单 内 容 ， 这 对 根据 业务 状态 读 取 不 同 表 单 非常 有 用 。 


注意 ， 每 个 activiti:formKey 属 性 都 以 “chapter6/leave-formkey/” 开 头 ， 表 示 包 的 路 径 。 图 6-29 展 示 了 外 置 表单 资源 内 容 的 目录 结构 。 
其 中 流程 定义 文件 和 表单 内 容 存放 在 src/main/resources/chapter6/leave-formkey 包 中 ， 对 应 的 单元 测试 是 src/test/java/me/kafeitu/activiti/LeaveFormKeyTest.java,。 


在 部 署 外 置 表单 流程 时 需要 把 流程 定义 文件 和 表单 文件 打包 部 署 ， 因 为 当 读 取 表 单 (启动 事件 和 用 户 任务 ) 时 会 以 当前 流程 的 部 署 ID 和 activiti:formKey 属 性 为 过 滤 条 件 ， 所 以 当 部 署 了 同名 的 form 文 
件 时 多 个 流程 定义 或 相同 流程 不 同 版 本 间 也 不 会 冲突 。 


在 流程 定义 文件 中 指定 的 form 文 件 的 名 称 需要 在 部 署 包 (压缩 文件 ) 中 保持 相同 的 层级 。 和 Java 的 jar 包 类 似 ， 源 码 中 的 路 径 和 jar 文 件 中 class 所 在 的 路 径 相 同 。 图 6-30 展 示 了 压缩 文件 leave- 
formkey.zip 的 目录 结构 ， 和 图 6-29 方 框 内 的 资源 路 径 匹 配 。 
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BE modify-apply.form 

Ba report-back.form 
下 = Cata 

四 activiti.cfg.xml 


流程 定义 文人 
以 及 表单 


application. properties 
be applicationContext.xml 


PY log4j.properties ee 
FT> src/test/java 单元 测试 类 
名 > me.kafeitu,activiti 
bp 四 AbstractTest.java 
je ni LeaveDynamicFormTest.java 
Wh > LeaveFormKeyTest.java / 


图 6-29 外 置 表单 资源 的 目录 结构 


S| leave-formkey.zip 


下 r 加 chapter6 Today 1 10 AM 
TY | leave-formkey Today, 1:10 AM 


| "| leave-formkey.bpmn Today, 1:01 AM 

二 leave-formkey.png Today, 12:45 AM 
| | leave-start.form Today, 12:52 AM 
modify-apply.form Today， 12:54 AM 
mi report=back.form Today, 12:56 AM 
_ | approve.form Today, 12:53 AM 


图 6-30 压缩 文件 leave-formkey.zip 文 件 的 目录 结构 


6.3.2 单元 测试 


外 置 表单 和 动态 表单 的 API 仅 在 读 取 表 单 内 容 上 有 区 别 ， 提 交 表 单 内 容 的 API 和 动态 表单 相同 ， 都 是 以 键 值 对 方式 保存 表单 字段 值 ， 如 代码 清单 6-19 所 示 。 


代码 清单 6-19 ”外 置 表单 的 单元 测试 


public class LeaveFormKeyTest extends AbstractTest { 


@Test 

QDeployment (resources = { "chapter6/leave-formkey/leave-formkey .bpmn" 
"chapter6/leave-formkey/leave-start.form", / ， 流程 表单 和 流程 定义 文件 
"chapter6/leave-formkey/approve. form", 一 同 部 署 ， 否 则 引擎 会 提示 
"chapter6/leave-formkey/report-back.form", 找 不 到 表单 文件 
"chapter6/leave-formkey/modify-apply.form" }) 

OE void allPass() throws Exception 1{ 


ttp://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15030/OEBPS/Text/... // 省 略 了 部 分 代码 
/ / 读 取 启动 表单 
Object renderedStartForm = = 
ormService.getRenderedStartForm(processDefinition.getId()); #2 
.， // 省 略 了 部 分 代码 


// 部 门 领导 审批 通过 
Task deptLeaderTask = taskService.createTaskQuery () 
.taskCandidateGroup ("deptLeader") .singleResult () ， 
assertNotNull (formService.getRenderedTaskForm (deptLeaderTask.getId())); #3 
} 
} 


执行 单元 测试 时 需要 把 所 有 使 用 到 的 表单 文件 和 流程 定义 一 同 部 署 ， 所 以 在 代码 清单 6-19 的 #1 处 用 一 个 字符 数组 作为 部 署 参 数 ， 在 #2 和 和 #3 处 分 别 读 取 了 启动 流程 的 表单 和 任务 表单 。 值 得 注意 的 是 动 
态 表单 读 取 的 表单 返回 的 是 一 个 Form 对 象 (StartFormData 和 TaskFormData) ， 而 外 置 表单 默认 用 纯 文本 格式 返回 表单 文件 的 内 容 。 


6.3.3” 自 定义 表单 引擎 


既然 Formservice 接 口 的 getRendered*Form() 方 法 返回 一 个 纯 文 本 的 内 容 ， 为 什么 接口 的 返回 类 型 是 Object 而 不 是 String 呢 ?在 第 1 章 中 就 提 到 了 Activiti 是 一 个 BPM 平 台 ， 不 管 是 B/S 还 是 C/S 结 构 的 
应 用 都 可 以 使 用 Activiti 作 为 流程 引擎 ， 对 于 B/s 结 构 的 应 用 来 阅 ， 一 般 用 HTML 作 为 表现 层 ， 但 是 对 于 C/s 来 说 HTML 的 纯 文 本 代码 明显 不 能 作为 C/S 的 基础 组 件 ， 例 如 Java 的 Swing、SWT 等 通过 java 对 象 
的 方式 显示 控件 ， 那 么 如 何 生成 适用 于 C/S 程 序 的 表单 呢 (可 以 由 Java 的 Swing、AWT、SWT 控 件 对 象 组 成 ) ? 


Activiti 支 持 自 定义 表单 引擎 以 适应 各 种 场景 ， 默 认 的 表单 引擎 (org.activiti.engine.impl.form.JuelFormEngine) 是 基于 Juel 实 现 的 ， 该 引擎 可 以 计算 表单 文件 中 EL 表达 式 作为 表单 内 容 ， 所 以 当 调 用 
Formservice 接 口 的 getRendered*Form() 方 法 后 得 到 的 内 容 是 经 过 Form 引 警 处 理 过 的 。 


继续 回答 如 何 让 Activiti 生 成 C/S 程 序 所 需 的 Java 控 件 : 创建 自 定义 的 表单 引擎 。 和 自 定 义 表单 字段 类 型 类 似 ， 创 建 自 定义 表单 引擎 只 需要 实现 接口 org.activiti.engine.impl.form.FormEngine， 然 后 像 
注册 自 定 义 表 单 类 型 一 样 在 引 警 中 注册 自 定 义 的 表单 引擎 实现 类 。 


代码 清单 6-20 列 出 了 自 定 义 表单 引擎 MyFormEngine 的 简单 实现 ， 可 以 生成 一 个 Swing 的 按钮 控件 。 


代码 清单 6-20 ” 自 定义 表单 引擎 


public class MyFormEngine implements FormEngine { 
QOverride 
public String getName () { 
return "myformengine"; // 表单 引擎 的 名 称 


} 

QOverride // 生成 启动 流程 表单 

public Object renderStartForm(StartFormData startForm) { 
javax.swing.JButton jButton = new javax.swing.JButton (); 

JjButton.setName ("My Start Form Button"); 

return jButton; 


} 
QOverride // 生成 用 户 任 务 表单 
public Object renderTaskForm(TaskFormData taskForm) { 

JjJavax.swing.JButton jButton = new javax.swing.JButton () ， 
JjButton.setName ("My Task Form Button"); 

return jButton; 

} 

} 


定义 了 表单 引擎 实现 之 后 在 引擎 配置 中 进行 注册 配置 ， 如 代码 清单 6-21 所 示 。 


代码 清单 6-21 注册 自 定义 的 表单 引擎 


<bean id="processEngineConfiguration" 
class="org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration"> 
<property name="customFormEngines"> 
<list> 
<bean class="me.kafeitu.activiti.chapter6.form.MyFormEngine" /> 
</list> 
</property> 
</bean> 


接着 用 单元 测试 验证 我 们 的 表单 引 警 是否 能 够 正常 工作 ， 代 码 清单 6-22 列 出 了 测试 自 定义 表单 引擎 的 代码 。 


代码 清单 6-22 ”测试 自 定义 表单 引擎 


public class MyFormEngineTest extends AbstractTest { 
@Test 
QDeployment (resources = { "chapter6/leave-formkey/leave-formkey.bpmn", 
"chapter6/leave-formkey/leave-start.form" }) 

public void allPass() throws Exception { 

ProcessDefinition processDefinition = repositoryService 
.CreateProcessDefinitionQuery() .singleResult () ; 

// 读 取 启动 表单 


Object renderedStartForm = formService 
.getRenderedStartForm(processDefinition.getId(), "myformengine"); #1 
// 验证 表单 对 象 
assertNotNull (renderedStartForm); #2-S 
assertTrue (renderedStartForm instanceof javax.swing.JButton); 
Javax.swing.JButton button = (JButton) renderedStartForm; 
assertEquals ("My Start Form Button", button.getName ()); #2 一 E 


在 代码 清单 6-22 中 ，# 1 处 在 调用 接口 获取 表单 内 容 时 添加 了 一 个 参数 “myformengine”， 明 确 指定 了 生成 表单 不 再 使 用 默认 的 表单 引擎 ， 而 是 使 用 在 引擎 中 注册 过 且 名 称 为 “myformengine” 的 表 
单 引擎 生成 表单 内 容 。#2 处 用 几 个 断言 验证 我 们 的 表单 引 警 是 否 可 以 创建 我 们 所 需要 的 基于 Swing 的 按钮 控件 。 


6.3.4 ” 读 取 流程 启动 表单 


在 6.1.3 节 把 一 个 动态 表单 的 例子 部 署 到 了 Activiti Explorer 中 ， 在 启动 流程 时 可 以 看 到 一 个 根据 表单 字段 生成 的 表单 ， 但 是 很 遗憾 Activiti Explorer 不 支持 外 置 表单 ， 所 以 本 节 基 于 对 外 置 表单 的 理解 为 
Activiti Explorer 添 加 外 置 表单 支持 。 


首先 把 图 6-30 中 的 压缩 文件 leave-formkey.zip 部 署 到 引擎 中 ， 完 成 部 署 后 列表 中 多 出 了 一 条 外 置 表单 的 请 假 流 程 ， 如 图 6-31 所 示 。 


流程 定 光 ID 流程 定 必 名 称 流程 定义 KEY 版 本 号 。 XML 资源 名 称 图 片 资源 名 称 操作 


laave-formkey:1:920 请 假 流程 -外 置 表单 laave-formkey 1 laave-formkey.bpmn 曾 删除 


laave:1:204 请 候 流程 -动态 表单 laave laave.bpmn laave.png 兽 型 除 


laave:2:912 育 慨 尝 秆 到 表征 laave leave.bpmn leave.png 菌 删除 


图 6-31 部 署 了 请 假 流程 的 外 置 表单 流程 定义 


单 击 “ 启 动 ” 按 钮 后 显示 如 图 6-32 的 页 面 ， 表 单 内 容 为 空 。 


启动 流程 一 请 假 流程 -外 置 表单 ， 版 本 号 : 1 ism 


了 > 启动 流程 


图 6-32 ”没有 表单 内 容 的 流程 启动 界面 


6.2.2 节 的 读 取 表单 的 代码 不 能 读 取 外 置 表单 内 容 ， 这 里 利用 6.3.1 和 6.3.2 所 学 的 技术 要 点 把 原来 的 方法 稍 加 改造 即 可 支持 外 置 表单 的 读 取 。 改 造 的 方法 很 简单 ， 可 以 通过 流程 定义 对 象 
ProcessDefinition (图 6-31 中 列表 的 列 即 流程 定义 对 象 的 属性 ) 的 hasSstartFormKey() 方 法 进行 验证 。 代 码 清单 6-23 列 出 了 如 何 判断 是 否 有 外 置 表单 。 


代码 清单 6-23 ”根据 流程 定义 的 方法 判断 是 否 有 外 置 表单 


public class ProcessDefinitionController extends AbstractController { 
QRequestMapping (value = "getform/start/{processDefinitionId}") 
public ModelAndView readStartForm(@PathVariable ("processDefinitionId") String processDefinitionId) throws Exception { 


ProcessDefinition processDefinition=repositoryService.createProcessDefinitionQuery () 
.DrocessDefinitionId (DrocessDefinitionId) .singleResult () ， 
boolean hasStartFormKey = DrocessDefinition.hasStartEFormKey () ， #1 
// 根据 是 否 有 formkey 属 性 判断 使 用 哪个 展示 层 
String viewName = "chapter6/start-process-form"; 


ModelAndView mav = new ModelAndView (viewName) ， 
f (hasStartFormKey) { // 判断 是 否 有 formkey 属 性 ”#2-S 

Object renderedStartForm = formService.getRenderedStartForm(processDefinitionId); 
mav.addobject ("startFormData", renderedStartForm); 

mav.addobject ("processDefinition", processDefinition); 


else { // 动态 表单 字段 


PP- 


i 


StartFormData startFormData = formService.getStartFormData (processDefinitionId); 
mav.addobject ("startFormData", startFormData); 

} #2-E 

mav.addobject ("hasStartFormKey", hasStartFormKey); 


mav.addObject ("processDefinitionId", processDefinitionId); 
return mav; 


代码 清单 6-23 在 代码 清单 6-7 的 基础 上 进行 了 改进 ， 改 进 后 可 以 支持 读 取 动态 表单 和 外 置 表单 ， 主 要 改进 有 以 下 两 点 。 
. #1 处 从 流程 定义 对 象 中 获取 是 否 具 有 外 置 表单 的 特征 (formKey 属 性 不 为 空 ) 。 
. #2 处 根据 变量 hasStartFormKKey 的 值 决定 使 用 哪个 方法 读 取 表单 ， 当 值 为 ttue 时 使 用 外 置 表单 的 方式 读 取 ， 否 则 使 用 动态 表单 的 方式 读 取 。 


鲍 ; 明 外 置 表单 文件 的 内 容 就 是 普通 的 HITMIL， 读 者 可 以 打开 本 书 配套 资源 文件 的 chapter6-o0a-forms/src/main/tesources/chapter6/leave-formkey 目 录 中 的 form 文 件 查看 。 


如 此 ， 单 击 图 6-31 中 第 一 条 记录 的 “启动 ”按钮 将 显示 图 6-33 所 示 的 页 面 ， 从 图 中 可 以 看 出 表单 内 容 和 Ileave-start.form 文 件 的 内 容 一 致 。 


启动 流 程 一 [请假 流程 -外 置 


制 返回 列表 | 了 局 动 流 程 


图 6-33 ”请 假 流程 一 一 外 置 表 单 启动 界面 
要 兼容 动态 表单 和 外 置 表单 表现 层 也 需要 做 出 调整 ， 根 据 不 同 的 情况 处 理 表单 内 容 。 代 码 清单 6-24 列 出 了 基于 代码 清单 6-8 调 整 后 的 start-process-formjsp 文 件 的 代码 片段 。 


代码 清单 6-24 ”基于 代码 清单 6-8 调 整 后 的 start-process-form.jsp 文 件 的 代码 片段 


<h3> 司 动 流程 一 
<c:if test="${hasSstartFormKey} "> 
[${processDefinition.name}]， 版 本 号 : ${processDefinition.version} 
</Cif> 
<c:if test="${!hasStartFormKey}"> 
[${startFormData.processDefinition.name}]， 版 本 号 : 
$s{startFormData.processDefinition.version} 
</C:if> 


</h3> 
<form action="${ctx }/chapter6/process-instance/start/$ {processDefinitionId}" 
class="form-horizontal" method="post"> 
<c:if test="${hasSstartFormKey} "> 
$s{startFormData} 
</C LE> 
<c:if test="${!hasStartFormKey}"> 
<C:forEach items="${startFormData.formProperties}" var="fp"> 
… // 此 处 省 略 了 代码 清单 6-8 的 html 元 素 转换 


> 


</c:if 
</form> 


代码 清单 6-24 主 要 是 根据 hasStartFormKey 的 值 进行 判断 处 理 ， 如 果 是 外 置 表单 ， 直 接 将 字符 型 的 变量 startFormData 输 出 即 可 ， 因 为 表单 内 容 是 纯 文本 的 HTML 代 码 。 


最 后 单 击 图 6-32 的 “启动 流程 ”按钮 向 后 台 提交 局 动 流程 请 求 ， 同 样 需 要 做 出 调整 以 兼容 外 置 表单 。 需 要 调整 的 是 读 取 表单 字段 值 的 部 分 ， 因 为 动态 表单 可 以 通过 读 取 流 程 定义 的 启动 表单 字段 列表 得 


知 需要 从 请 求 参数 列表 读 取 哪 些 表 单字 段 值 。 对 于 外 置 表单 ， 因 为 没有 在 流程 定义 文件 中 进行 描述 ， 只 是 把 表单 内 容 都 保存 在 单独 的 form 文 件 中 ， 所 以 对 于 这 样 的 情况 只 能 读 取 所 有 的 请 求 参 数 作为 流程 启 
动 参数 。 代 码 清单 6-25 列 出 了 兼容 读 取 动 态 表 单 和 外 置 表单 内 容 的 代码 。 


代码 清单 6-25 ”启动 流程 时 根据 表单 类 型 使 用 不 同 的 表单 参数 处 理 方式 


public String startProcessInstance (GPathVariable ("processDefinitionId") String pdid, HttpServletRequest request) { 
ProcessDefinition processDefinition = repositoryService.createProcessDefinitionQuery () 
.processDefinitionIid (pdid) .singleResult (); 

boolean hasStartFormKey = DrocessDefinition.hasStartEFormKey () ， #1 

Map<String, String> formValues = new HashMap<String, String>(); 

if (hasStartFormKey) { // 外 置 表单 
Map<String, String[]> parameterMap = request.getParameterMap () ， #2 
Set<Entry<String, String[]>> entrySet = parameterMap.entrySet (); 

for (Entry<String, String[]> entry : entrySet) { 

String key = entry.getkey (); 

formValues.put (key, entry.getValue() [0]); 


} 
} else { // 动态 表单 

// 先 读 取 表单 字段 ， 再 根据 表单 字段 的 ID 读 取 请 求 参 数值 

StartFormData formData = formService.getStartFormData (pdidqd); 

// 从 请 求 中 获取 表单 字段 的 值 
List<FormProperty> formProperties = formData.getFormProperties () ， 
for (FormProperty formProperty : formProperties) { 
String value = request.getParameter (formProperty.getId()); 
formValues.put (formProperty.getId(), value); 


在 代码 清单 6-25 的 #1 处 获取 是 否 有 formKey 属 性 。 在 #2 处 处 理 有 formKey 属 性 的 情况 ， 读 取 全 部 请 求 参数 列表 ， 动 态 表 单 的 处 理 方式 保持 不 变 。 


代码 清单 6-25 读 取 了 请 求 参数 集合 中 的 所 有 参数 作为 局 动 流程 参数 ， 如 果 有 写字 段 值 不 需要 保存 到 数据 库 ， 就 会 导致 引擎 数据 库 多 出 很 多 垃圾 数据 。 在 实际 应 用 中 可 以 设 定 一 些 规 则 处 理 ， 比 如 需要 保 
存 到 数据 库 的 字段 以 一 个 特殊 的 前 级 开头 。 


<input type="text" id="endTime" name="fp endTime"/> 


以 一 个 特殊 的 前 缀 “fp_” 开头 ， 表 示 这 个 字段 需要 保存 到 数据 库 ， 这 样 在 处 理 请 求 参数 时 就 可 以 根据 这 个 特殊 的 前 缀 进行 过 滤 ， 伪 代码 如 下 : 


Els 


F (parameter.startsWith("fp ")) { 
String[] paramSplit = parameter.split (™ "); 
formProperties.put (paramSplit[1], entry.getValue() [0]); 


单 击 图 6-32 中 的 “启动 流程 ”按钮 后 成 功 启 动 一 个 流程 实例 ， 在 图 6-34 中 列 出 了 包含 “请 假 流程 -外 置 表单 ”流程 任务 ID 为 1511 的 任务 。 


任务 ID 任务 名 称 流程 实例 ID 流程 定 光 ID 任务 创建 时 间 


1511 部 门 经 理 审批 1501 leave-formkey:1:1445 SUN Dec O02 22.44:42 GST 2012 


图 6-34 请假 流 程 一 一 外 置 表 单 的 任务 


加 说 明 ”使 用 activiti:formKey 属 性 除了 可 以 指定 一 个 form 文 件 的 名 称 外 ， 还 可 以 指定 一 个 页 面 的 访问 路 径 ， 在 jBPM4 中 使 用 过 这 种 方法 的 读者 可 以 继续 使 用 ， 通 过 FormService 的 接口 读 取 formKey 属 性 后 
再 访问 表单 内 容 。 


6.3.5 ”任务 签收 与 办 理 


单 击 图 6-34 的 “签收 ”按钮 并 单 击 之 后 的 “办 理 ” 按 钮 跳 转 到 任务 办 理 页 面 ， 如 图 6-35 所 示 。 


任务 办 理 一 [部 门 经 理 审 批 ]， 流 程 定 义 ID: [leave-formkey:1:1445] 


申请 人 : 


开始 时 间 : 


结束 时 间 : 2012=12-02 


请 假 原因 : 公休 


| 同意 


制 返回 列表 完成 任务 


图 6-35 ”任务 办 理 


读 取 外 置 表单 


从 图 6-35 中 可 以 看 到 流程 定义 ID 为 “leave-formkey:1:1445” ， 表 明 该 任务 是 “请 假 流 程 -外 置 表单 ”流程 定义 产生 的 。 和 读 取 启动 流程 表单 兼容 动态 表单 和 外 置 表单 一 样 ， 对 于 任务 表单 同样 需要 兼 
容 两 种 不 同 的 表单 形式 。 


代码 清单 6-26 在 代码 清单 6-12 的 基础 上 添加 了 一 个 变量 hasFormKey， 以 便 在 展示 层 可 以 作为 判断 表单 类 型 的 依据 。 


代码 清单 6-26 ”基于 代码 清单 6-12 添 加 hasFormKey 变 量 


GReauestMapping (value = "task/getform/{taskId}") 
public ModelAndView readTaskForm(@PathVariable ("taskId") String taskId) throws Exception { 
tring viewName = "chapter6/task-form"; 
odelAndView mav = new ModelAndView (viewName) ， 
askFormData taskFormData = formService.getTaskFormData (LaskId) ， 
Ff (taskFormData.getFormKey() != null) { // formKey 不 为 空 表示 是 外 置 表单 
Object renderedTaskForm = formService.getRenderedTaskForm (taskId); 
Task task = taskService.createTaskQuery() .taskId (taskId) .singleResult ();) 
mav.addobject ("task", task); 
mav.addobject ("taskFormData", renderedTaskForm); 
mav.addOobject ("hasFormKey", true); // 标记 为 外 置 对 
} else { 
mav.addobject ("taskFormData", taskFormData); 
} 


return mav; 


号 


-站 


1 
上 


对 应 的 展示 层 也 需要 进行 调整 ， 类 似 代码 清单 6-24， 代 码 清单 6-27 列 出 了 任务 办 理 页 面 的 调整 。 


代码 清单 6-27 调整 任务 办 理 页 面 以 兼容 外 置 表单 


<h3> 任 务 办 理 -[${hasFormKey ? task.name : taskFormData.task.name}]， 流 程 定 义 ID: [${hasFormKey? task.processDefinitionId : taskFormData.task.processDefinitionId}]</h3> 

<form action="${ctx }/chapter6/task/complete/$ {hasFormKey ? task.id : taskFormData. task.id}" class="form-horizontal" method="post"> 
<c:if test="${hasFormKey}">${taskFormData}</c:if> // 直接 输出 外 置 表单 内 容 
<c:if test="${!hasFormKey}"> 
<C:forEach items="${taskFormData.formProperties}" var="fp"> 

http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15030/OEBPS/Text/... // 省 略 了 部 分 代码 

</c:forEach> 

</form> 


代码 清单 6-27 的 加 粗 部 分 就 是 用 hasFormKey 变 量 进 行 的 判断 处 理 ， 可 以 很 好 地 兼容 两 种 表单 的 内 容 显示 。 不 过 从 Activiti 5.16 版 本 开始 可 以 不 借助 hasFormKey 变 量 判断 表单 类 型 ， 因 为 在 此 版 本 中 可 
以 从 Task 对 象 中 获取 到 formKey 属 性 ， 该 属性 值 也 会 保 人 存在 运行 时 和 历史 任务 表 的 “FORM_KEY_” 字 段 中 。 


外 置 表单 除了 配置 一 个 文件 的 相对 路 径 外 还 可 以 配置 URL， 例 如 把 Activiti 作 为 流程 中 心 (基于 Activiti Rest 服 务 ) 对 外 提供 服务 时 可 以 使 用 这 种 方式 分 离 业 务 与 流程 ， 也 就 是 Activiti 负 责 业 务 流程 的 驱 
动 ， 而 业务 的 表单 还 是 交 给 各 个 业务 系统 处 理 ， 相 关内 容 读者 可 以 参考 20.7.2 节 。 


6.4 ”本章 小 结 


本 章 内 容 讲 解 了 Activiti 支 持 的 两 种 表单 : 动态 表单 、 外 置 表单 ， 这 是 流程 引擎 系统 中 最 重要 的 一 部 分 内 容 ， 是 机 器 与 人 类 交互 的 重要 载体 。 针 对 每 一 种 表单 都 进行 了 以 下 几 方 面 的 详细 讲解 : 
“ 如 何在 流程 定义 中 定义 表单 信息 (表单 字段 、 表 单 名 称 ) 。 

“ 如 何在 启动 流程 时 读 取 表单 。 

` 如 何 读 取 任 务 的 表单 内 容 。 


“ 如 何 保存 表单 字段 内 容 到 引擎 数据 库 。 


在 动态 表单 部 分 还 对 如 何 自 定义 表单 字段 类 型 进行 了 详细 的 讲解 ， 以 此 满足 对 于 现 有 控件 或 特殊 字段 类 型 的 需求 。 


在 外 置 表单 中 用 实例 方式 讲解 如 何 定义 自己 的 动态 表单 引擎 ， 使 外 置 表单 的 使 用 方位 不 再 局 限 B/S 架构 ， 通 过 自 定 义 表单 引 擎 同样 可 以 利用 Activiti 引 擎 创建 适用 于 C/S 架 构 的 表单 对 象 。 


第 7 章 ”Activiti 与 容器 集成 


Spring 是 由 Rod Johnson 发 起 的 轻 量 级 开发 框架 ， 经 过 多 年 的 发 展 已 经 非常 成 熟 ， 并 且 应 用 于 大 多 数 企 业 应 用 中 ， 通 过 简单 的 配置 即 可 和 其 他 的 框架 集成 ， 利 用 IOC 实 现 解 耦合 ， 利 用 AOP 拦 截 事务 、 


日 志 等 。 


Activiti 从 最 开始 设计 时 就 考虑 了 与 Spring 的 集成 ， 从 引 警 的 默认 配置 文件 (activiti.cfg.xml) 就 可 以 看 出 ， 其 实 Activiti 的 配置 文件 解析 及 XML 规范 都 是 基于 Spring 扩展 的 。 这 一 特点 对 于 Activiti 和 现 有 
系统 的 集成 可 以 说 是 水 到 渠 成 ， 所 以 本 章 的 内 容 将 从 各 个 方面 讲解 Activiti 的 Spring 模块 (activiti-spring) 可 以 帮 有 我 们 做 哪些 事情 ; 如 何 和 现 有 系统 进行 集成 ， 包 括 Bean 的 注入 、 统 一 事务 管理 等 。 


7.1 


通过 JDB( 方 式 访问 数据 库 首 先 需要 加 载 对 应 数据 库 的 驱动 ， 只 有 基于 JDBC 标 准 实现 的 数据 库 驱 动 才 能 和 目标 数据 库 通信 。 在 流程 引擎 中 创建 引擎 是 第 一 步 ， 只 有 通过 引擎 对 象 才能 操作 引擎 数据 库 
(通过 接口 调用 ) 。 


创建 引擎 对 象 的 方式 有 很 多 种 ， 在 下 面 的 章节 中 我 们 会 学 到 使 用 多 种 方式 创建 引擎 的 方法 ， 例 如 创建 基于 内 存 数 据 库 的 引擎 用 于 单元 测试 ， 或 者 通过 引擎 配置 对 象 动态 配置 后 创建 引擎 对 象 。 


7.1.1 创建 引擎 的 方式 


下 面 的 代码 可 以 通过 ProcessEngineConfiguration 类 创建 一 个 动态 的 基于 内 人 存 数 据 库 的 引擎 对 象 。 


ProcessEngine processEngine = ProcessEngineConfiguration 
.CreateStandaloneInMemProcessEngineConfiguration () 
.buildProcessEngine () ; 


在 单元 测试 中 还 可 以 使 用 ActivitiRule 类 创建 用 于 测试 的 引 警 对象， 例如 下 面 的 代码 均 可 创建 一 个 用 于 测试 的 引擎 对 象 。 


@Rule 

ActivitiRule activitiRule = new ActivitiRule()， 
ProcessEngine engine = activitiRule.getProcessEngine () ; 
// 指定 一 个 配置 文件 名 称 
String resourceNam Vactiviti Cfo mL 
@Rule 
ActivitiRule activitiRule = new ActivitiRule (resourceName); 
ProcessEngine engine2 = activitiRule.getProcessEngine () ， 


当 需 要 多 个 引擎 时 还 可 以 通过 设置 引擎 的 名 称 区 分 其 他 的 引擎 对 象 ， 例 如 下 面 的 代码 创建 了 一 个 名 称 为 “oracleEngine” 的 引擎 ， 并 有 目 动态 设置 了 数据 库 参 数 ， 最 后 通过 ProcessEngines 类 读 取 名 称 
为 “oracleEngine” 的 引擎 对 象 。 


ProcessEngineConfiguration.createProcessEngineConfigurationFromResourceDefault () 
.SetProcessEngineName ("oracleEngine") 
.SetJdbcDriver ("oracle.Jjdbc.Driver") 
.SetJdbcUrl1 ("jdbc:oracle:thin:@localhost:1521 :XE") 
.SetJdbcUsername ("dbusername") 
.SetJdbcPassword ("password") 
.SetDatabaseType ("oracle") 
.buildProcessEngine () ; 
ProcessEngine oracleEngine = 
ProcessEngines .getProcessEngine ("oracleEngine"); 


当 创建 流程 引 警 时， 每 个 引 警 都 有 一 个 唯一 的 名 称 ; 当 创 建 引擎 对 象 时 ， 为 显示 地 调用 setProcessEngineName() 方 法 ， 引 警 会 使 用 默认 的 引擎 名 称 “default” 作 为 引擎 名 称 ， 所 以 下 面 代码 的 执行 结 
果 为 true。 


ProcessEngine processEngine = ProcessEngineConfiguration 
.CreateStandaloneInMemProcessEngineConfiguration () 


.buildProcessEngine () ; 
assertEquals ("default", processEngine.getName () ) ， 


7.1.2 配置 ProcessEngineFactoryBean 


与 Spring 集成 的 目的 是 把 获取 引 警 和 Service 的 方式 由 Spring 代理 统一 管理 ， 以 及 业务 与 流程 引擎 的 统一 事务 管理 (这 也 是 与 Spring 集成 的 一 个 重要 原因 ) 。Activiti 提 供 了 一 个 专门 的 模块 “activiti- 
spring”， 由 Spring 团队 的 布道 者 Josh Long 主 导 开 发 。 


在 Maven 项 目 中 使 用 Activiti 的 Spring 模块 ， 需 要 在 pom.xml 文 件 中 添加 activitispring 模 块 的 依赖 ， 依 赖 代 码 如 下 : 


<dependency> 
<groupId>org.activiti</groupId> 
<artifactId>activiti-spring</artifactId> 
<version>5.11</version> 

</dependency> 


在 传统 项 目 中 ， 需 要 把 activiti-spring-5.x.jar 引 入 到 classpath 中 (Web 类 型 的 项 目 放 在 /WEB-INF/lib 目 录 下 ) 。 


采用 哪 种 引擎 创建 方式 ， 都 先 设置 一 系列 参数 ， 然 后 根据 这 些 参数 创建 引擎 对 象 。 对 于 Spring 方式 也 是 一 样 ， 首 先 需要 配置 一 个 类 名 
为 “org.activiti.spring.SpringProcessEngineConfiguration” 的 Bean 对 象 来 设置 创建 引擎 所 需 的 参数 。 代 码 清单 7-1 列 出 了 基于 Spring 的 引擎 配置 Bean 对 象 的 XML 定义 片段 。 


代码 清单 7-1 基于 spring 的 引擎 配置 Bean 对 象 的 XML 定义 片段 


<bean id="processEngineConfiguration" 
class="org.activiti.spring.SpringProcessEngineConfiguration"> #1 


</bean> 


<bean id="processEngine" class="org.activiti.spring.ProcessEngineFactoryBean"> #2 
<property name="processEngineConfiguration" ref="processEngineConfiguration" /> 
</bean> 
代码 清 擎 配置 Bean， 其 id 为 “procesEngineConfiguration” ， 当 然 这 个 id 可 以 随意 定义 ， 但 是 要 保证 其 唯一 性 。 


擎 配置 对 象 注入 类 名 为 “org.activiti.spring.ProcessEngineFactoryBean” 的 Bean 中 。 


如 此 ， 当 加 载 Spring 配 置 文件 创建 上 下 文 对 象 (ApplicationContext) 时 就 会 创建 定义 的 两 个 Bean 对 象 。 


在 SpringProcessEngineConfiguration 中 的 配置 和 在 activiti.cfg.xml 中 的 配置 基本 类 似 ， 可 以 配置 数据 库 参 数 或 引擎 
理 器 。 


一 点 需要 特别 声明 ， 那 就 是 事务 管 


对 于 7.1.1 节 列举 的 创建 引擎 


擎 采用 Mybatis 内 置 的 事务 管理 器 ， 如 果 使 用 Spring 方式 创建 引擎 ， 就 必须 明确 指定 一 个 事务 管理 器 。 
代码 清单 7-2 列 出 了 基于 Spring 的 引擎 配置 以 及 代理 Service 的 XML 配置 的 代码 ，XML 文 件 位 于 chapter7-spring/src/test/resources/applicationContext-test.Xxml。 


代码 清单 7-2 ”基于 spring 的 引 警 配置 以 及 代理 service 的 XML 配置 


<?Xml Version="1.0"” encoding="UTF-8"?> 
<beans xmlns="http://www.springframework.org/schema/beans" xmlns:context="http://www.springframework.org/schema/context" 
xmlns:tx="http://www.springframework.org/schema/tx" xmlns:xsi="hnttp://www.w3.org/2001/XMLSchema-instance" // 引入 xsd 文 件 
xsi:schemaLocation="http://www.springframework.org/schema/beans // 以 及 xmlns 声 明 
http://www.springframework.org/schema/beans/spring-beans .xsd 
http://www.springframework.org/schema/context 
http://www.springframework.org/schema/context/spring-context-3.1.xsd "> 
<bean idq="qataSource"  ”// 创建 基于 内 存 数 据 库 的 数据 源 #1-S 
class="org.springframework.jdbc.datasource.SimpleDriverDataSource"> 

<property name="driverClass" value="org.h2.Driver" /> 

<property name="url" value="jdbc:h2:mem:activiti;DB CLOSE DELAY=1000" /> 

<property name="username" value="sa" /> 


<property name="password" value="" /> 
</bean> #1 一 | 
<bean id="transactionManager" // 定义 事务 管理 器 ， 并 注入 数据 源 #2-S 


class="org.springframework.jdbc.datasource.DataSourceTransactionManager"> 
<property name="dataSource" ref="dataSource" /> 


</bean> 
<tx:annotation-driven transaction-manager="transactionManager" // 注解 方式 配置 事务 
proxy-target-class="true" /> #2-E 
<bean id="processEngineConfiguration" // 定义 基于 Spring 的 引擎 配置 对 象 Bean #3-S 
class="org.activiti.spring.SpringProcessEngineConfiguration"> 

<property name="dataSource" ref="dataSource" /> 
<property name="transactionManager" ref="transactionManager" /> 

<property name="databaseSchemaUpdate" value="true" /> 

<property name="jobExecutorActivate" value="false" /> 


</bean> #3 一 EE 
// 配置 引擎 工厂 Bean 
<bean id=" processEngineFactory" #4-S 


class="org.activiti.spring.ProcessEngineFactoryBean"> 
<property name="processEngineConfiguration" ref="processEngineConfiguration" /> 


</bean> #4 一 

<bean id="repositoryService" factory-bean="processEngineFactory" #5-S 
factory-method="getRepositoryService" /> 

<bean id="runtimeService" factory-bean="processEngineFactory" 


factory-method="getRuntimeService" /> 


e 
e 

<bean id="formService" factory-bean="processEngineFactory" 
e 
e 


factory-m thod="ge tFormService™" /> 
<bean id="identityService" factory-bean="processEngineFactory" 
factory-method="getIdentityService" /> 


<bean id="taskService" factory-bean="processEngineFactory" 
factory-method="getTaskService" /> 

<bean id="historyService" factory-bean="processEngineFactory" 
factory-method="getHistoryService" /> 

<bean id="managementService" factory-bean="processEngineFactory" 
factory-method="getManagementService" /> #5-E 


</beans> 


代码 清单 7-2 的 配置 分 为 几 个 部 分 : XML 的 命名 空间 、 数 据 源 、 事 


擎 配置 、 引 擎 


xml 头 部 声明 了 几 个 XML 的 命名 空间 ， 相 比 activiti.cfg.xml 多 出 了 前 缀 为 tx 的 命名 空间 ， 用 来 定义 事务 方面 的 配置 。 


#1 处 使 用 Spring 的 简单 数据 源 类 创建 了 数据 源 ， 使 用 的 是 内 存 关 


擎 实现 类 StandalonelnMempProcessEngineConfiguration 的 配置 类 似 。 


#2 处 定义 了 事务 管理 器 Bean 对 象 ， 并 用 tx:annotation-driven 声 明 使 用 注解 配置 事务 。 注 解 事务 是 可 选 的 ， 读 者 可 以 继续 使 用 XML 方式 声明 事务 管理 机 制 。 


#3 处 在 代码 清单 7-1 已 经 介绍 过 了 ， 这 


擎 配置 对 象 中 注入 了 几 个 必要 的 属性 ， 尤 其 是 事务 管理 器 是 必 不 可 少 的 。 


#4 处 定义 一 个 引擎 


擎 配置 Bean 对 象 processEngineConfiguration， 如 此 通过 工厂 对 象 就 可 以 创建 


擎 对 象 是 受 保护 类 型 ) 。 


#5 处 分 别 用 Spring 提供 的 工矿 方式 获取 Activiti 的 7 个 Service 接 口 对 象 ， 这 样 就 可 以 很 方便 地 使 用 Spring 的 工具 类 获取 Service 实 例 或 者 通过 注解 方式 将 Activiti 的 Service 接 口 对 象 注入 被 Spring 代理 的 
Bean 中 。 


代码 清单 7-3 针 对 代码 清单 7-2 的 配置 进行 了 测试 ， 以 验证 其 能 够 正确 创建 引擎 


代码 清单 7-3 ”测试 代码 清单 7-2 的 配置 是 人 否 可 以 创建 引擎 对 象 


public class CreateEngineUseSpringProxy { 


@Test 
public void createEngineUseSpring() { 
ClassPathXxmlApplicationContext context = new 


ClassPathXxmlApplicationContext ("applicationContext-test.xml"); 
ProcessEngineFactoryBean factoryBean = 

context .getBean (ProcessEngineFactoryBean.class); 

assertNotNull ( Oe // 验证 获取 的 工厂 对 象 是 否 不 为 空 

RuntimeService bean GOnt tBean (RuntimeService.class); 
assertNotNull (bean);  // 验证 否 正 常 获取 RuntimeService 对 象 


De 
避 


代码 清单 7-3 通 过 创建 ClassPathXmlApplicationContext 对 象 的 方式 解析 Spring 配 置 文件 读 取 被 代理 对 象 ， 运 行 单元 测试 后 顺利 通过 ， 如 图 7-1 所 示 。 


Finished after 1.78 seconds 


Runs: 1/1 图 Errors: 心 目 Failures: OQ 


Ls BE me.kafeitu.activiti.chapter7.engine.CreateEngineUseSpringProxy [Runner: JUnit 4| (1,.755 s) 汪 Failure Trace 


图 7-1 运行 代码 清单 7-3 的 测试 代码 的 结果 


除了 使 用 传统 的 方式 获取 Bean 对 象 之 外 ， 还 可 以 使 用 基于 注解 的 方式 ， 如 代码 清单 7-4 所 示 。 


代码 清单 7-4 ”使 用 注解 方式 测试 代码 清单 7-2 的 配置 是 否 可 以 创建 引擎 对 象 


QRunWith (SpringJUnit4ClassRunner.class) 
QContextConfiguration("classpath:applicationContext-test.xml") 
public class CreateEngineUseSpringProxyByAnnotation { 


QAutowired 

RuntimeService runtimeService; // 注入 RuntimeService #1 
QAutowired 

ProcessEngineFactoryBean factoryBean; // 注入 工厂 类 #2 

QTest 


public void testService () throws Exception { 
assertNotNull (runtimeService); 3 
ProcessEngine processEngine = factoryBean.getObject (); #4 
assertNotNull (processEngine.getRuntimeService()); #5 
} 
] 


代码 清单 7-4 使 用 注解 方式 由 Spring 注 入 Bean 对 象 ， 在 #1 处 注入 了 RuntimeService 并 在 #3 处 验证 注入 的 runtimeService 变 量 不 为 空 ; 在 #4 处 通过 代码 调用 方式 获取 引擎 对 象 ， 这 也 是 在 代码 清单 7- 
2#5 处 的 Java 代 码 实现 。 


7.2 ”自动 部 署 流程 定义 

自动 部 署 是 通过 Spring 方式 创建 流程 引擎 的 一 个 独 有 功能 ， 可 以 在 初始 化 引 警 时 自动 把 定义 的 资源 部 署 到 引擎 中 。 部 署 的 方式 是 利用 Spring 提供 的 Resource[1] 功 能 实现 的 ， 可 以 使 用 多 种 方式 配置 资源 
路 径 ， 例 如 classpath、file 等 。 

但 是 关于 这 个 功能 ， 有 些 读 者 可 能 会 问 ， 如 果 每 次 启动 应 用 都 会 加 载 Spring 配置 文件 并 初始 化 流程 引擎 ， 岂 不 是 每 次 都 部 署 一 个 新 的 版 本 ? 


答案 是 不 会 ， 在 5.2.1 节 中 介绍 了 使 用 DeploymentBuilder 部 署 流程 定义 ， 细 心 的 读者 可 能 发 现 了 一 个 方法 为 enableDuplicateFitering0， 这 个 方法 的 作用 是 排除 重复 的 流程 定义 ， 所 以 只 有 流程 数据 库 
中 没有 和 自动 部 署 的 流程 定义 相同 的 记录 才 会 部 署 ， 否 则 会 忽略 ， 不 会 出 现 启动 多 次 应 用 后 部 署 多 个 版 本 的 流程 定义 问题 。 


有 了 理论 基础 后 再 通过 单元 测试 方式 学 习 如 何 配置 自动 部 署 流程 定义 ， 代 码 清单 7-5 在 代码 清单 7-2 的 基础 上 添加 了 自动 部 署 资源 的 配置 项 ， 文 件 名 为 applicationContext-autodeployment.xml。 


代码 清单 7-5 ”添加 了 自动 部 署 资 源 的 引擎 配置 


<bean id="processEngineConfiguration" class="org.activiti.spring.SpringProcessEngineConfiguration"> 
<property name="dataSource" ref="dataSource" /> 
<property name="transactionManager" ref="transactionManager" /> 
<property name="databaseSchemaUpdate" value="true" /> 
<property name="jobExecutorActivate" value="false" /> 
<property name="deploymentResources" 
value="classpath*:/chapter6/leave-formkey/leave-formkey.bpmn"></property> 


</bean> 


代码 清单 7-5 中 添加 的 deploymentResources 属 性 配置 了 一 个 classpath 方 式 的 资源 路 径 ， 读 取 classpath 中 的 leave-formkey.bpmn 文 件 ， 如 果 有 多 个 资源 ， 还 可 以 使 用 通配符 形式 匹配 多 个 资源 文件 ， 
例如 classpath*:/chapter6/**/*.bpmn 可 以 匹配 到 所 有 chapter6 目 录 下 (包括 子 目 录 ) 扩展 名 为 bpmn 的 文件 。 


对 应 的 单元 测试 代码 见 代码 清单 7-6 所 示 。 
代码 清单 7-6 ”测试 流程 定义 自动 部 署 


QRuNWith (SpringJUnit4ClassRunner.class) 
QContextConfiguration ("classpath:applicationContext-autodeployment .xml") 
public class AutoDeploymentUseSpring { 
@Autowired 
RepositoryService repositoryService; 
@Test 
public void testAutoDeployment () {{ 
long count = repositoryService.createProcessDefinitionQuery() .count (); 
assertEquals (1, count); 
} 
} 


代码 清单 7-6 的 代码 比较 简单 ， 仅 仅 通 过 流程 定义 查询 接口 统计 已 部 署 的 流程 定义 数量 ， 期 望 结 果 为 1 表示 和 预期 一 致 。 
如 果 代 码 清单 7-5 中 的 deploymentResources 配 置 的 是 “classpath*:/chapter6/**/*.bpmn”， 那 么 查询 到 的 流程 定义 数量 应 该 为 2。 
此 功能 对 于 新 系统 的 上 线 或 者 在 开发 过 程 中 加 入 新 的 流程 非常 有 用 ， 可 以 自动 部 署 引 擎 数据 库 中 不 存在 的 或 者 修改 过 的 流程 定义 。 


[1] http://static.springsource.org/spring/ docs/3.1.3.RELEASE /spring-framework-reference/html/resources.htmlo 


7.3 ”表达 式 


7.3.1 ”表达 式 基 础 


我 们 知道 ， 在 流程 定义 中 几乎 所 有 的 属性 都 可 以 使 用 变量 方式 定义 ， 这 样 可 以 在 运行 中 灵活 地 设置 ， 例 如 在 第 6 章 请 假 流程 的 流程 定义 文件 中 ， 对 于 领导 与 人 事 的 审批 判断 使 用 变量 来 判断 执行 排他 分 支 
的 哪 一 条 输出 流 。 


流程 定义 文件 中 出 现 的 判断 条 件 的 语句 或 者 调用 一 个 Bean 的 方法 都 称 为 表达 式 。 对 表达 式 的 解析 由 JUEL 根 据 UEL (Unified Expression Language) 规范 实 


足 更 多 的 需求 。 


相信 和 熟悉 JSP 的 读者 对 UEL 并 不 陌生 了 ， 通 过 ${} 包 应 的 表达 式 即 可 读 取 变 量 值 、 计 算 变 量 值 等 操作 。 不 过 ， 经 过 Activiti 改 造 过 的 UEL 功 能 更 加 的 强大 ， 表 7-1 列 举 了 一 些 表达 式 的 典型 应 用 。 


${myVar)} 
${myVar.name} 


${serviceBean.confirm()} 


${serviceBean.confirm 
(henryyan )} 


${serviceBean.confirm 
(name, execution)} 


execution 


task 


authenticatedUserld 


在 Activiti 中 表达 式 应 用 非常 广泛 ， 通 过 表达 式 可 以 动态 计算 ( 读 取 ) 一 切 可 以 计算 的 表达 式 ， 从 而 获取 动态 值 。 例 如 可 以 动态 设置 用 户 任务 的 办 理 人 (activiti:assignee 属 性 ) ， 执 行 一 个 Java Service 


表 7-1 UEL 表 达 式 的 应 用 示例 
获取 变量 名 称 为 myVar 的 变量 值 
从 变量 myVar 中 该 取 name 属性 
执行 变量 名 称 为 serviceBean 的 confirmO 方法 


执行 变量 名 称 为 serviceBean 的 confirm() 方法 ， 同 时 以 字符 串 henryyan 作 为 参 
数 。 这 里 字符 串 也 可 以 使 用 变量 代替 ， 如 果 在 变量 中 包含 一 个 名 称 为 name 的 变量 ， 
就 可 以 动态 设置 方法 的 参数 ， 例 如 $f{serviceBean.confirm(name)} 


量 名 称 为 serviceBean 的 confirm() 方法 ， 并 9 和 人 名称 为 name 的 变量 作 
为 第 个 参数 ， 传人 入 引 敬 内置 的 变量 execution 作为 第 二 个 和 参数。 关于 引 苟 内置 的 


表 7-2 ”引擎 内 置 的 三 个 变量 
变量 含义 

此 变量 在 运行 阶段 总 是 可 以 调用 ， 对 应 接口 : org.activiti.engine.delegate.Dele- 
gateExecution， 可 以 获取 流程 实例 的 变量 ,包含 了 一 些 执行 期 的 信息 项 ， 例 如 流程 实 
例 ID 、 下 务 ID ( businessKey， 如 果 在 启动 流程 时 指定 了 就 可 以 获取 )、 当 前 节点 等 
信息 ， 另 外 在 5.11 版 本 中 还 可 以 直接 获取 引擎 的 7 个 Service 接口 

风 果 FE 流程 定 义 中 添加 了 执行 监听 需 (实现 ExecutionListener 接口 ) 或 者 为 革 

“活动 添加 了 Delegate (实现 JavaDelegate 接口 )， 那 么 接口 将 提供 一 个 Delegate- 
En 的 对 象 作 为 参数 


变量 含义 


相对 于 execution 来 说 task 变量 的 作用 域 就 比较 小 了 ，execution 可 以 在 整个 运 
行 期 的 所 有 活动 上 使 用 ， 但 是 task (DelegateTask 接口 ) 仅 本 支持 用 户 任 务 (User 
Task)， 而 且 限 定 为 expression 类 型 pe 所 以 通过 此 变量 可 以 设置 或 者 读 取 任 
务 相 关 的 变量 ， 设 置 任 务 办 理 人 或 者 候选 人 等 ， 基 本 涵义 -用 :任务 相关 的 所 有 属 
性 以 及 特性 . 

例如 ， 下 面 的 配置 可 以 在 一 个 用 户 任 务 创建 时 执行 一 个 表达 式 ， 并 在 执行 时 把 
DelegateTask 的 对 象 传 给 家 调用 对 象 的 方法 : 


<userTask id="usertaskl1" 
name=" 在 用 户 任 务 上 添加 表达 式 "> 
<extensionElements> 
<activiti:taskListener 
event="create" 
expression="$ {myBean.invokeTask (task)}"> 
</activiti:taskListener> 
</extensionElements> 
</userTask> 


此 变量 仅 在 启动 流程 实例 前 调用 IdentityService 的 setAuthenticatedUserId() 方 
法 时 才 会 由 引擎 提供 ， 获 取 的 方式 很 何 单 ， 执 行 $ {fauthenticatedUserId}》 即 可 


任务 ， 或 者 执行 Execution 监 听 器 、Task 监 听 器 ， 还 有 在 请 假 流程 中 排他 分 支 的 输出 流 条 件 判断 等 。 


之 后 Activiti 又 对 JUELIN 进 行 了 扩展 以 满 


在 Activiti 中 ， 所 有 表达 式 中 出 现 的 变量 均 需 要 实现 序列 化 接口 java.io.Serializable。 在 前 面 的 讲解 中 通过 各 种 接口 设置 的 变量 均 保存 到 了 数据 库 ， 类 型 有 字符 串 、 日 期 、 数 字 等 ， 这 些 基 本 格式 类 在 JDK 
中 均 已 实现 序列 化 接口 。 对 于 自 定义 的 JavaBean 来 说 ，Activiti 可 以 保存 一 个 自 定义 的 Bean 对 象 到 数据 库 。 


如 果 一 个 自 定义 Bean 没 有 实现 序列 化 接口 ， 那 么 将 会 得 到 类 似 如 下 的 异常 提示 


org.activiti.engine.ActivitiException: couldn't find a variable type that is able to serialize me.kafeitu.activiti.chapter7.expression.MyBean@58bd3b2d 


对 于 表 7-2 中 的 三 个 内 置 变量 ， 需 要 特别 说 明 一 下 ， 仪 能 通过 表达 式 获 取 ， 不 能 通过 RuntimesService 或 TaskService 的 getVariable() 方 法 获取 。 
7.3.2 ”表达 式 示 例 


程序 员 在 解决 一 个 问题 时 最 喜欢 看 到 的 是 具体 的 代码 ， 有 了 前 面 的 理论 的 基础 ， 下 面 就 用 单元 测试 的 方式 帮助 彻底 理解 表 7-1 和 表 7-2 中 表达 式 及 内 置 变量 如 何 应 用 。 


首先 设计 了 一 个 用 于 测试 的 流程 定义 ， 其 ID 为 “expression” ， 该 流程 定义 包含 三 个 节点 ， 分 别 用 于 测试 不 同 的 表达 式 ， 如 图 7-2 所 示 。 


获取 流程 局 动人 


Li 
在 用 户 任务 上 添加 


图 7-2 ”理解 表达 式 的 辅助 流程 定义 
图 7-2 对 应 的 流程 定义 XML 文件 见 代 码 清单 7-7。 


代码 清单 7-7 ”图 7-2 所 示 的 流程 定义 XML 


<process id="expression" name="expression"> 

<startEvent id="starteventl" name="Start"></startEvent> 

<serviceTask id="execExpression" name=" 计 算 表 达 式 " #1-S 
activiti:expression="$ {myBean.print (name)}" // 执行 myBean 的 print () 方 法 
activiti:resultVariableName="returnValue">  // 结果 保存 到 变量 returnValue 中 

</serviceTask> #1-E 

<userTask igd="usertaskl" name=" 在 用 户 任务 上 添加 表达 式 "> #2-S 

<extensionElements> // 调用 myBean 的 invokeTask 方 法 ， 并 传递 内 置 变量 task 


<activiti:taskListener event="create" expression="$ {myBean.invo-keTask (task) }"/ > #2-1 </extensionElements> 
</userTask> #2-E 
<serviceTask id="getAuthenticatedUserId"” name=" 获 取 流 程 启动 人 " #3-S 


activiti:expression="${authenticatedUserId}" // 获取 内 置 变量 authenticatedUserId 
activiti:resultVariableName="authenticatedUserIdForTest"></serviceTask>#3-E 


<serviceTask id="executionExample" name="Execution 变 量 " #4-S 
activiti:expression="$ {myBean.printBkey (execution)}" 
activiti:resultVariableName="businessKey"></serviceTask> #4—E 

</process> 


代码 清单 7-7 基 本 涵盖 了 表达 式 的 几 种 使 用 方式 ，#1 处 演示 了 调用 一 个 Bean 对 象 的 方法 并 将 一 个 名 称 为 ame 的 自 定义 变量 作为 方法 的 参数 ; #2 处 在 #1 的 基础 上 更 改 了 参数 ， 将 引擎 内 置 的 变量 task 作 为 
被 调用 方法 的 参数 ; #3 处 获取 引擎 内 置 的 变量 authenticatedUserId， 并 演示 了 如 何 把 表达 式 的 结果 保存 到 另外 一 个 变量 中 ， 如 在 #3-E 处 把 authenticatedUserId 的 值 保存 在 名 称 为 authenticatedUserIdFortTest 的 变量 
中 ; #4 处 则 融合 了 #2 处 和 #3 处 的 特性 ， 既 在 调用 方法 时 传 入 引擎 内 置 变 量 execution， 又 把 方法 的 执行 结果 保存 到 变量 businessKey 中 。 


如 果 对 于 本 节 开 头 的 文字 内 容 理解 得 差不多 ， 青 加 上 代码 清单 7-7 的 示例 ， 相 信 读 者 对 于 表达 式 的 应 用 已 经 掌握 得 差不多 了 ， 下 面 对 这 一 切 的 “假设 ”用 代码 来 一 一 验证 。 代 码 清单 7-8 对 代码 清单 7-7 
做 了 完整 的 测试 。 


代码 清单 7-8 ”代码 清单 7-7 对 应 的 单元 测试 代码 


public class ExpressionTest extends AbstractTest { 


@Test 
QDeployment (resources = "diagrams/chapter7/expression.bpmn") 
public void testExpression() { 
MyBean myBean = new MyBean();  // 首先 将 需要 的 变量 初始 化 
Map<String, Object> variables = new HashMap<String, Object>(); 


variables.put ("myBean", myBean); // 创建 一 个 可 以 序列 化 的 MyBean 对 象 
String name = "Henry Yan"; variables.put ("name", name); 


// 运行 期 表达 式 
identityService.setAuthenticatedUserId ("henryyan"); // 设置 启动 流程 人 ID # 工 
String businessKey = "9999"; // 业务 ID 
ProcessInstance processInstance = runtimeService // 在 启动 流程 时 设置 业务 ID 
.StartProcessInstanceByKey ("expression", businessKey, variables);#2-5S 
assertEquals ("henryyan", runtimeService // 对 应 代码 清单 7-7 的 #3 处 
ro a nstance.getId(), "authenticatedUserIldForTest")) ;#2-E 
assertEquals ("Henry Yan, added by print (String name)"， // 对 应 代码 清单 7-7 的 村 处 #3 
runtimeService.getVariable (processInstance.getId(), "returnValue")); 
assertEquals (businessKey， // 对 应 代码 清单 7-7 的 #4 处 
runtimeService.getVariable (processInstance.getId(), "businessKey")); 
// DelegateTask 设置 的 变量 
Task task = taskService.createTaskQuery () // 查询 任务 并 验证 变量 
4-S 
.DrocessInstanceId (DrocessInstance.dgetId()) .singleResult (); 
S 


tring setByTask = (String) taskService.getVariable (task.getId(), "setByTask"); 


assertEquals ("I'm setted by DelegateTask, " + name, setByTask); #4-E 


} 
} 
// 自 定义 的 Bean 对 象 


class MyBean implements java.io.Serializable { // 必须 实现 序列 化 接口 #5 
public void print() { System.out .Println("print content by print()"); } 
public String print (String name) 1 

System.out .Println("print content by print (String name), value is :" + name); 
return name += ", added by print (String name)™; 


} 
public void invokeTask (DelegateTask task) { // 接收 名 称 为 task 的 引擎 内 置 变量 
task.setVariable ("setByTask", "I'm setted by DelegateTask, " + task.getVariable ("name")); 


} 
public String printBkey (DelegateExecution execution) { // 接收 名 称 为 execution 的 引擎 内 置 变量 
String processBusinessKey = execution.getProcessBusinessKey () ， 
System.out.println ("process instance id: " + execution.getProcessInstanceId () 
+ ", business key: " + processBusinessKey); 
return processBusinessKey; 
} 
} 


在 代码 清单 7-8 中 ， 关 键 位 置 都 已 用 文字 说 明 ， 结 合 代 码 清单 7-7 的 解释 不 难 理解 表达 式 的 执行 方式 及 过 程 。 


从 #5 处 开始 一 直到 结束 定义 了 一 个 名 称 为 MyBean 的 类 ， 并 且 实 现 了 序列 化 接口 ， 如 此 在 #1 处 创建 了 一 个 MyBean 类 的 对 象 并 以 myBean 变 量 名 称 作为 启动 流程 的 参数 (启动 流程 之 后 引擎 会 把 
myBean 以 二 进 制 流 的 格式 保存 到 数据 库 ) 。 


针对 #2 处 要 特别 说 明 一 点 ， 相 比 之 前 的 情况 这 里 在 启动 流程 时 添加 了 一 个 参数 businessKey 作 为 业务 ID， 当 业务 数据 不 保存 在 引擎 数据 库 时 ， 这 个 参数 必须 传 入 ， 否 则 无 从 得 知 流程 实例 属于 哪个 业 
务 ， 使 用 外 置 表单 时 可 以 选择 是 否 设置 业务 1D， 一 般 在 业务 数据 库 保 存 成 功 后 将 得 到 的 记录 主键 作为 流程 实例 的 业务 ID， 如 此 业务 数据 和 流程 数据 就 建立 了 关系 。 


#2-E、#3、#4 处 逐一 验证 流程 执行 的 结果 ， 其 中 #3 和 交 处 的 变量 均 被 MyBean 类 的 方法 处 理 后 返回 。 
7.3.3 ”使 用 Spring 管理 变量 


使 用 Spring 管理 变量 可 以 避免 由 引擎 保存 复杂 变量 ( 自 定义 的 Bean) 到 数据 库 ， 如 果 变 量 需 要 事务 管理 Spring 可 以 统一 事务 管理 。 
在 代码 清单 7-8 执 行 完成 后 ， 检 索 数据 库 的 历史 信息 (对 应 表 名 ACT_HI_DETAIL) ， 会 得 到 一 条 如 下 的 记录 (在 代码 清单 7-8 的 测试 类 中 添加 了 输出 数据 库 状 态 的 代码 ， 读 者 可 自行 查看 ) : 


REV = 0 

NAME = myBean 
ACT INST ID = 6 
VAR TYPE = serializabl 
BYTEARRAY ID = 12 

ID =13 | 
TIME = 2012-12-14 22:19:33.537 
TYPE = VariableUpdate 
EXFECUTION ID = 5 


PROC INST ID = 5 


(0 


从 上 面 的 输出 结果 中 可 以 判定 ， 引 擎 把 名 称 为 myBean 的 对 象 持久 化 到 了 数据 库 ， 这 也 是 为 什么 变量 都 需要 实现 序列 化 接口 的 原因 。 在 输出 结果 中 ， 字 段 “BYTEARRAY_ID_” 对 应 的 值 为 “12”， 对 应 
表 ACT_GE_BYTEARRAY (此 表 保 存 了 二 进 制 流 数据 ) 中 的 记录 。 


本 节 将 在 7.3.2 的 基础 上 改造 ， 由 Spring 代理 复杂 对 象 MyBean， 而 不 再 需要 由 引擎 持久 化 到 数据 库 。 


改造 的 过 程 很 简单 ， 在 代码 清单 7-8 的 开始 出 我 们 创建 了 一 个 MyBean 的 实例 ， 代 码 清 单 7-9 把 MyBean 交 给 Spring 代理 ， 并 且 注 入 引 警 中， 如 此 ， 当 获取 编码 myBena 时 就 可 以 直接 从 Spring 上 下 文中 
获取 。 


代码 清单 7-9 在 Spring 引 警 实现 中 注入 自 定义 Bean 


<bean id="processEngineConfiguration" class="org.activiti.spring.SpringProcessEngineConfiguration"> #1 


<property name="beans"> #2-5 
<map> // entry 的 key 属 性 就 是 变量 名 称 


<entry key="myBean" value-ref="myBean"></entry> 
</map> 
</property> 
</bean> #2-E 
<bean id="myBean" class="me.kafeitu.activiti.chapter7.expression.MyBean" /> #3 


代码 清单 7-9 的 #2 处 通过 设置 引擎 的 预 设 参数 “beans” 设置 了 一 个 map 集 合 ， 使 用 #3 处 id 为 “myBean” 的 Bean 对 象 作 为 集合 的 元 素 ， 简 单 两 步 即 完成 了 自 定义 Bean 的 注入 。 
当然 除了 使 用 #3 处 的 XML 定义 之 外 ， 还 可 以 使 用 注解 方式 由 Spring 自动 扫描 并 代理 ，#2 处 的 配置 不 变 。 
代码 清单 7-10 的 ExpressionWithspringTest 类 继承 了 activiti-spring 模 块 的 一 个 测试 基 类 SpringActivitiTestCase， 和 代码 清单 7-8 的 区 别 在 于 不 再 创建 MyBean 对 象 。 


代码 清单 7-10 ”使 用 Spring 代理 自 定 义 Bean 作 为 流程 变量 的 单元 测试 


QContextConfiguration ("classpath:applicationContext-expression.xmlL") 
public class ExpressionWithSpringTest extends SpringActivitiTestCase { 
QDeployment (resources = "diagrams/chapter7/expression.bpmn") 
public void testExpression() { 
Map<String, Object> variables = new HashMap<String, Object>(); 
String name = "Henry Yan"; 
variables.put ("name", nam 


全 > 
// 其 他 代码 和 代码 清单 7-8 一 样 ， 故 省 略 


再 次 运行 单元 测试 ， 顺 利通 过 后 的 结果 如 图 7-3 所 示 。 


Finished after 2.739 seconds 


Runs: 1/1 图 Errors: 0 四 Failures: 0 


Wb ME] me.kafeitu.activiti.chapter7.expression.ExpressionWithspringTest [Runmer: JUnit 4] (2.529 5) = Failure Trace 


图 7-3 ”代码 清单 7-10 执 行 单元 测试 顺利 通过 


既然 Activiti 紧 密 结合 Spring 作为 基础 组 件 ， 能 否 不 使 用 Spring 也 可 以 代理 Bean 呢 ?当然 可 以 ， 代 码 清 单 7-11 展 示 了 在 activiti.cfg.xml 中 添加 自 定 义 Bean 的 配置 。 


代码 清单 7-11 在 Standalone 引 擎 中 注入 自 定义 Bean 


<bean id="processEngineConfiguration" class="org.activiti.engine.impl.cfg.StandaloneInMemProcessEngineConfiguration"> 


<property name="beans"> #2-5 
<map> // entry 的 key 属 性 就 是 变量 名 称 


<entry key="myBean" value-ref="myBean"></entry> 
</map> 
</property> 
</bean> #2-E 
<bean id="myBean" class="me.kafeitu.activiti.chapter7.expression.MyBean" /> #3 


[1] http://juel.sourceforge.net/index.html，JUEL 不 仅 作为 一 个 开源 的 EL 解析 工具 ， 而 且 是 JSP2.1 (JSR-245 规 范 ) 中 EL 的 解析 器 ， 已 经 被 集成 到 了 JAVAEE5 中 。 


fy 


74 监听 器 


在 4.7 节 中 已 经 大 臻 了解 了 监听 器 的 作用 及 基本 的 配置 方式 ， 代 和 码 清单 7-7 的 #2-1 处 已 经 涉及 了 任务 监听 器 的 使 用 ， 本 节 将 以 实例 方式 讲解 监听 器 的 具体 使 用 ， 
锚 建 议 ”读者 可 以 回顾 一 下 4.7 节 的 内 容 ， 本 节 的 实例 以 4.7 节 的 内 容 为 基础 。 


对 于 监听 器 的 配置 已 经 陆续 涉及 了 ， 本 节 的 主要 内 容 是 如 何在 监听 器 中 注入 自 定 义 字 段 ， 以 及 如 何 使 用 Spring 代理 监听 器 对 象 。 


为 了 更 好 地 理解 监听 器 与 字段 注入 如 何 使 用 ， 下 面 结合 图 7-4 的 流程 来 讲解 。 


从 图 7-4 中 看 不 出 这 个 流程 要 做 什么 ， 代 码 清单 7-12 列 出 了 该 流程 的 XML 代码 。 


代码 清单 7-12 ”图 7-3 对 应 的 XML 


<process id="listener" name="11stener"> 


<extensionElements> 
<activiti:executionListener event="start" // 以 class 方 式 配 置 流 程 启动 监听 器  # 虹 
class="me.kafeitu.activiti.chapter7.listener.ProcessStartExecutionListener"/ > 
<activiti:executionListener event="engd" #2 


// 以 qdelegateExpression 方 式 配置 流程 结束 监听 器 
delegateExpression="$ {endListener}"></activiti:executionListener> 
</extensionElements> 
<startEvent id="starteventl" name="Start"></startEvent> 
<endEvent id="endeventl1l" name="End"></endEvent> 
<userTask idq="usertask1" name=" 任 务 监 听 器 " activiti:assignee="henryyan"> 
<extensionElements> 
<activiti:taskListener event="create" // 为 该 任务 添加 任务 创建 监听 器 #3 
class="me.kafeitu.activiti.chapter7.listener.CreateTaskListener"> 
<activiti:field name="content"> // 为 监听 器 注入 字段 content #4-S 
<activiti:expression>Hello, ${name}</activiti:expression> 
</activiti:field> #4-E 
<activiti:field name="task"> // 为 监听 器 注入 字段 引擎 内 置 变量 task #5-S 
<activiti:expression>${task}</activiti:expression> 
</activiti:field> #5-E 
</activiti:taskListener> 
<activiti:taskListener event="assignment" // 配置 任务 分 配 监听 器 #6 
delegateExpression="${assignmentDelegate}"/> 
</extensionElements> 
</userTask> 
</process> 


代码 清单 7-12 中 的 #1、#2、#3 处 分 别 配 置 了 三 个 监听 器 ， 其 中 #1、#2 处 把 监听 器 绑 定 在 流程 实例 的 创建 与 结束 事件 上 ，#1 使 用 class 方 式 配 置 了 一 个 类 ， 而 #2 使 用 表达 式 (delegateExpression) 方 
式 配置 ， 在 运行 时 动态 指定 。 


#3 处 把 监听 器 绑 定 在 用 户 任务 “任务 监听 器 ”的 create 事 件 上 ， 当 任务 被 创建 时 执行 监听 器 配置 的 class 属 性 的 类 ， 并 且 在 调用 监听 器 时 注入 两 个 字段 content 和 task。 


在 开始 单元 测试 之 前 先 了 解 一 下 为 监听 器 注入 字段 如 何 配置 ， 图 7-5 展 示 了 在 Activiti Designer 揪 件 中 如 何 设置 监听 器 的 字段 注入 。 


Java class 人 ) Expression (© Delegate expression (© Alfresco script 


LL Selectcass | 


图 7-5 ”使 用 Eclipse 播 件 Activiti Designet 为 监听 器 设置 注入 字段 
经 过 图 7-5 的 配置 后 ，XML 代 码 如 代码 清单 7-12 的 #3、#4、#5 处 所 示 ， 监 听 器 实现 类 中 必须 有 同名 的 上 且 类 型 为 Expression 的 字段 ， 可 以 选择 性 地 提供 字段 的 setter 方 法 ， 如 果 没有 setter 方 法 ， 引 警 会 
通过 反射 机 制 设 置 变量 ( 即 设置 访问 权限 为 private) 值 。 
字段 的 值 可 以 是 一 个 纯 文本 (content 字 段 的 “Hello，” 部 分 ) ， 也 可 以 是 表达 式 (content 字 段 的 tname}) ， 并 且 两 者 可 以 混用 ; 如 果 字 段 仅 仪 设 置 了 纯 文 本 ， 那 么 在 XML 中 将 使 用 
<activiti:string> 标 签 代替 < activiti:expression> ， 但 是 在 监听 器 的 类 中 还 是 需要 使 用 Expression 作 为 字段 的 类 型 。 


在 了 解 了 监听 器 与 字段 注入 的 配置 方式 后 ， 下 面 针 对 代码 清单 7-12 的 流程 定义 使 用 单元 测试 的 方式 来 学 习 监听 器 何 时 被 调用 ， 字 段 如 何 注入 。 
代码 清单 7-13 列 出 了 流程 启动 与 结束 监听 器 的 实现 。 


代码 清单 7-13 ”流程 启动 与 结束 监听 器 实现 类 


// 流程 实例 启动 监听 器 实现 类 

public class ProcessStartExecutionListener implements ExecutionListener ({ #1 

public void notify (DelegateExecution execution) throws Exception { 
execution.setVariable ("setIinStartListener", true); 


System.out .Println(this.dgetClass () .getSimpleName() + ", " + execution.getEventName()); 
} 
} 
// 流程 实例 结束 监听 器 实现 类 
ExecutionListener implements ExecutionListener，Serializable ({ #2 public voidq notify (Delec 


public class ProcessEnd 
execution.setVariable ("setInEndListener", true); 
System.out.println (this.getClass() .getSimpleName() + ", " + execution.getEventName()); 
} 
} 


流程 实例 级 别 的 监听 器 均 需要 实现 接口 org.activiti.engine.delegate.ExecutionListener， 此 接口 仪 有 一 个 方法 且 传 入 一 个 org.activiti.engine.delegate.DelegateExecution 对 象 作为 参数 ， 参 数 
execution 和 表 7-2 中 的 execution 是 一 个 对 象 ， 所 以 作用 也 是 一 样 的 。 
任务 (Task) 级 别 的 监听 器 与 流程 实例 级 别 的 监听 器 类 似 ， 只 不 过 前 者 的 参数 类 型 有 所 不 同 而 已 。 代 码 清单 7-14 列 出 了 任务 监听 器 ， 需 要 注意 的 是 ， 虽 然 名 称 为 “CreateTaskListener” 但 是 不 代表 就 


是 一 个 任务 创建 监听 器 ， 而 是 需要 在 流程 定义 文件 中 与 任务 事件 进行 绑 定 。 


代码 清单 7-14 ”任务 监听 器 实现 类 


public class CreateTaskListener implements TaskListener { 
private Expression content;  // 表达 式 注 入 字段 的 类 型 必须 为 Expression 
private Expression task; 
public void notify(DelegateTask delegateTask) { 
System.out.println (task.getValue (delegateTask) );，; 
delegateTask.setVariable ("setInTaskCreate", delegateTask.getEventName() + ", " 
+ Content .getValue (delegateTask) ); 
System.out .println(dqelegateTask.getEventName () + "， 任 务 分 配给 : " 
+ qeledgateTask.getAssignee () ) ， 
delegateTask.setAssignee ("jenny"); // 重新 分 配 任 务 给 jenny 


} 

// 字段 content、task 的 setter 方 法 可 以 省 略 
} 
// 监听 任务 分 配 


public class TaskAssigneeListener implements TaskListener，Serializable { 
public void notify(DelegateTask delegateTask) { 
System.out.println ("任务 分 配给 : " + delegateTask.getAssignee () ) ; 
} 
} 


代码 清单 7-14 的 CreateTaskListener 实 现 了 接口 org.activiti.engine.delegate.TaskListener， 和 流程 实例 级 别 的 监听 器 类 似 ， 都 需要 实现 一 个 notify() 方 法 ， 唯 一 不 同 的 是 参数 类 型 不 同 。 但 是 两 者 的 
notify() 方 法 的 参数 对 象 均 可 以 通过 调用 setEventName(0 方 法 获取 触发 监听 器 的 事件 类 型 ，DelegateExecution 的 事件 类 型 取 值 范围 为 statt、cend，DelegateTask 的 事件 类 型 取 值 范围 为 cteate、assignment、 


complete。 


代码 清单 7-15 对 配置 的 监听 器 执行 结果 进行 了 测试 ， 以 方便 读者 理解 执行 过 程 。 


代码 清单 7-15 ”监听 器 单元 测试 


public class ListenerTest extends AbstractTest { 

@Test 

QDeployment (resources = { "diagrams/chapter7/listener/listener.bpmn" }) 

public void testListener() { 
Map<String, Object> variables = new HashMap<String, Object> () ， 
// 创建 一 个 监听 器 实例 并 设置 到 变量 中 
variables.put ("endListener", new ProcessEndqExecutionListener () ) ， #1-S 
variables.put ("assignmentDelegate", new TaskAssigneeListener ()); #1 
variables.put ("name", "Henry Yan"); 
ProcessInstance ProcessInstance = runtimeService 

.StartProcessInstanceByKey ("listener", variables); 
// 校 验 是 否 执行 了 启动 监听 


String ProcessInstanceId = processInstance.getId(); 
assertTrue( (Boolean) runtimeService.getVariable (processInstancelId, "set-InStartListener")); 
// 校 验 任务 监听 器 是 否 被 执行 
Task task = taskService.createTaskQuery() .ProcessInstanceId (ProcessInstanceId) 
.taskAssignee ("jenny") .singleResult (); // 监听 器 已 经 把 任务 重新 分 配给 jenny 
String setInTaskCreate = (String) taskService.getVariable (task.getId(), "setInTaskCreate"); 
assertEquals ("create, Hello, Henry Yan", setInTaskCreate); #2 
taskService.complete (task.getId()); 
// 流程 结束 后 查询 变量 
List<HistoricVariableInstance> list = historyService.createHistoricVariableInstanceQuery () 
.processInstanceId (processInstanceId) .list(); // 查询 历史 变量 


boolean hasVariableOfEndListener = false; 
for (HistoricVariableInstance variableInstance : list) { 
if (variableInstance.getVariableName () .equals ("setInEngdListener")) { 


hasVariableOfEndListener = true; 


} 
} 
assertTrue (hasVariableOfEndListener); // 校 验 流程 结束 监听 器 是 否 被 执行 
} 
} 


代码 清单 7-15 针 对 每 个 监听 器 被 执行 的 情况 进行 了 验证 ，# 1 处 需要 注意 流程 结束 监听 器 是 动态 指定 的 一 个 对 象 ， 而 不 是 像 流程 启动 监听 器 一 样 显示 地 执行 一 个 class， 当 然 可 以 利用 7.3.3 的 方式 在 引擎 
配置 中 注入 流程 结束 监听 器 Bean。 


单元 测试 执行 完成 后 可 以 在 控制 台 看 到 类 似 如 图 7-6 所 示 的 输出 结果 ， 可 以 看 出 任务 监听 器 TaskAssigneeListener 被 执行 了 2 次 。 


ProcessSstartExecutionListener, start 
aqss1gnment， 任 冰 分 有 第 : henryyan 

Task[ 22 | 

12-12-16 16:24:46,.633 [main] DEBUG | 


2@12-12-16 16:24:46,633 [main] DEBUG | 
2012-12-16 16:24:46,633 [main] DEBUG | 
cregte， 任务 分 配给 : henryyanh 
aqssighnment， 任务 分 配给 : jenny 


图 7-6 ”ListenerTest 执 行 结 果 


从 7.3 节 和 7.4 节 对 表达 式 以 及 监听 器 的 学 习 可 以 看 出 ， 在 Activiti 中 可 以 通过 各 种 方法 灵活 运用 实现 业务 逻辑 的 处 理 ， 这 些 都 得 益 于 JEL 的 支持 ， 所 以 在 实际 应 用 中 要 选择 适合 团队 或 项 目的 方式 ， 利 用 
表达 式 和 监听 器 实现 业务 逻辑 的 处 理 。 


7.5 _ Spring 容器 集成 应 用 实例 
上 一 章 介绍 了 任务 表单 ， 包 括 动 态 表单 和 外 置 表单 ， 其 实在 实际 应 用 中 还 有 一 种 普通 表单 (暂且 这 么 定义 吧 ) ， 直 接 把 表单 的 内 容 写 在 表现 层 (JSP、JSF、HTML 等 ) 文件 中 ， 一 个 用 户 任务 对 应 一 个 
页 面 (或 者 将 内 容 放 在 一 个 文件 中 ， 根 据 节点 判断 显示 哪 部 分 内 容 ) 。 这 样 的 做 法 适用 于 业务 相对 比较 固定 、 业 务 比较 复杂 、 流 程 相对 固定 但 表现 层 变 化 比较 多 的 情况 。 


一 般 使 用 普通 表单 时 业务 数据 和 流程 数据 是 分 离 的 ， 这 就 牵扯 到 一 个 事务 问题 。 假 设 这 样 一 个 场景 ， 用 户 完成 一 个 任务 并 更 新 业务 数据 (更 改 了 表单 ) ， 表 假设 此 时 任务 已 经 执行 了 完成 (complete) 
操作 ， 但 是 在 更 新 表单 数据 时 失败 了 ， 所 以 更 改 执行 的 任务 完成 操作 就 要 回 滚 ， 此 时 就 要 保证 数据 的 一 致 性 。 


要 解决 这 样 的 问题 就 要 统一 事务 管理 ， 保 证 Activiti 与 业务 数据 操作 在 同一 个 事务 中 执行 。7.1.2 节 介绍 的 Spring 正 是 解决 此 问题 的 途径 ， 由 Spring 提供 统一 的 事务 管理 器 并 注入 到 Activiti 引 警 和 业务 层 
(Service 层 ) 中 。 


本 节 将 综合 本 章 内容 对 事务 问题 的 处 理 采 用 普通 表单 方式 设计 一 个 和 第 6 章 功 能 相同 的 请 假 流 程 ， 主 要 针对 在 数据 和 表单 都 分 离 的 情况 下 如 何 使 两 者 结合 。 
7.5.1 业务 建 模 


首先 对 数据 进行 建 模 ， 请 假 业 务 表 的 表 结 构 如 图 7-7 所 示 ， 从 表 结 构 上 看 和 第 6 章 中 的 表单 字段 基本 类 似 。 


Run (Cin+Enten)| | Clear| SQL statement 


Show COLUMNS from leave 


Show COLUMNS from leave: 

Dp eens) No lpr [exTvAL\ 
PROCESS INSTANCE IDIVARCHAR(64) |YES | INULL 
UsERJD VARGHARGZO) no | ut 
BTARTTME TMESTAVPG) NO | ut 
EO TME TMESTAVPG3) NO | ut 
EAVE TVPE |wRcHARBO |vES | ut 
REASON VARGHAR(Z000) YES | ut 
APPLY_TME TMESTAVPG3) NO | ut 
REALTY START_TME TIMESTAMP(23) YES | uc 
REALTY -END_TME |TMESTAMP(Z3) YES | ut 


图 7-7 请 假 业务 表 结 构 


对 业务 实体 的 映射 使 用 JPA 标 准 的 注解 方式 ， 即 使 用 目前 企业 应 用 中 比较 流行 的 ORM 框 架 Hibernate 作 为 持久 层 的 实现 ， 就 是 7.1.2 节 中 介绍 的 Spring 的 Activiti 引 警 并 统一 管理 业务 与 流程 的 事务 。 


本 节 的 内 容 将 全 部 使 用 Spring 代理 DAO、Manager 以 及 Spring MVC 的 Controller， 其 中 DAO 和 Manager 用 来 针对 请 假 实体 的 CRUD 操 作 。 另 外 还 要 创建 一 个 Leave-WorkflowService 类 来 处 理 流程 相 
关 操 作 ， 例 如 流程 启动 、 读 取 任 务 列表 等 。 


DAO 及 Manager 的 类 图 如 图 7-8 所 示 ，LeaveWorkflowService 的 代码 见 代 码 清单 7-16 所 示 。 


HH me.kafeitu.activiti.chaprter?.dao 

v CP LeaveDao 

o sessionNnFactory : SessionFactory 
save(Leave) : vold 

@ delete(Long) : void 

全 getlLong) : Leave 

国 getSsession(} : Session 


出 me.kafeitu.activiti.chapter?. sel 
MACE LeaveManager 

a leaveDao : LeaveDao 
saveltLeave) : VolId 
deletetLongl : void 
get(Long) : Leave 


图 7-8 请假 实体 相关 DAO 与 Managet 类 图 


DoD 


7.5.2 ”局 动 流程 


图 7-9 中 的 流程 定义 列表 包含 了 “请 假 流程 -普通 表单 ”流程 定义 ， 通 过 在 Spring 实现 的 流程 引擎 中 设置 “deploymentResources” 属性 自动 部 署 。 


Choose File |No file chosen [Submit | 
Choose File | ] 


流程 定义 ID 部 署 ID | 流程 定义 名 称 流程 定义 KEY 版 本 号 | XML 资源 名 称 图 片 资源 名 称 操作 
laavec1:1704 1701 ”请假 流程 -普通 表单 leave leave.bpmn leave.png 曾 肥 除 | | b> 启动 


图 7-9 ”包含 了 “请 假 流程 -普通 表单 ”的 流程 定义 列表 


ta 本 节 涉 及 的 流程 定义 文件 位 于 “chapter7/leave.bpmn”。 


代码 清单 7-16 请假 流 程 的 Service 


@Service 
@Transactional // 启用 事务 管理 
public class LeaveWorkflowService { 
private Logger logger = LoggerFactory.getLogger (getClass () ) ; 
QAutowired // 注入 业务 实体 管理 对 象 
LeaveManager leaveManager; 
@Autowired 
private IdentityService identityService; 
QAutowired // 注入 Activiti 相 关 Service 
站 RuntimeService runtimeService; 
// 保存 请 假 实体 并 启动 流程 
public ProcessInstance startWorkflow (Leave entity, 
String userId, Map<String, Object> variables) { // 
if (entity.getId() == null) { 
entity.setApplyTime (new Date () ) ; 
entity.setUserId (userId) ， 
} 
leaveManager.save (entity); // 持久 化 请 假 实体 #1 
String pusinessKey = entity.getId() .tostring(); // 实体 保存 后 的 ID， 作 为 流程 的 业务 Key 
// 用 来 设置 启动 流程 的 人 员工 D， 引擎 会 自动 把 用 户 [D 保 存 到 activiti:initiator 中 
identityService.setAuthenticatedUser] Td (userId); 
ProcessInstance processInstance = runtimeService // Re 
.StartProcess] [nstanceByKey ("leave", businessKey, variables); 
String processIinstanceld = processinstance.getId(); 
entity.setProcessInstanceId (processInstanceId); // 建立 双向 关系 ”#3 
logger.debug ("start process of {key={}, bkey={}, pigd={}, variables={}}", 
new Object[] { "leave", businessKey, processInstanceld, variables }); 
return processIinstance; 


代码 清单 7-16 有 两 处 和 以 往 不 同 ， 业 务 表 独 立 但 又 需要 和 流程 建立 关联 关系 ， 所 以 首先 把 业务 实体 持久 化 (#1 处 ) ， 然 后 利用 持久 化 后 得 到 的 业务 对 象 ID 作为 启动 流程 的 参数 (#2 处 
的 businessKey) ， 如 此 流程 中 保存 了 业务 的 主键 IiD。 但 是 为 了 方便 以 后 从 业务 层面 查询 流程 数据 ， 在 #3 处 的 业务 实体 中 设置 了 流程 实例 ID， 如 此 就 建立 了 业务 与 流程 的 双向 关联 关系 。 


当然 ， 在 代码 清单 7-16 的 #3 处 执行 的 建立 双向 关系 是 可 选 的 ， 这 样 做 的 目的 是 在 查询 时 可 以 明确 知道 该 业务 对 应 的 流程 数据 ID， 假 如 没有 在 业务 中 保存 流程 实例 的 ID， 那 么 两 者 联合 查询 要 以 流程 为 入 
口 ， 如 此 在 性 能 方面 就 大 打折 扣 了 。 这 样 做 还 有 另外 一 个 目的 ， 那 就 是 可 以 区 分 业务 数据 的 状态 ， 例 如 在 有 些 系统 中 会 区 分 已 启动 流程 和 未 启动 流程 的 数据 ， 根 据 业 务 数 据 
的 “PROCESS INSTANCE _ ID” 字段 是 否 为 空 可 以 很 容易 地 查询 不 同 状 态 的 数据 。 


从 代码 清单 7-16 可 以 看 出 ， 因 为 LeaveWorkflowservice 是 受 事务 控制 的 ， 所 以 本 节 开 始 的 那些 假设 都 可 以 正确 地 处 理 ， 如 果实 体 保 存 了 但 是 启动 流程 的 时 候 失 败 ， 则 全 部 回 滚 。 


在 本 节 开 始 时 就 提 到 了 使 用 普通 表单 时 需要 包 表 单 内 容 保存 在 一 个 单独 的 文件 中 ， 图 7-10 是 针对 请 假 流程 的 启动 设计 的 一 个 自 定义 表单 。 对 应 的 JSP 代 码 可 参见 chapter7- 
spring/src/main/webapp/WEB-INF/views/chapter7/leave/leaveApply.jsp, 


Activiti Explorer 会 首页 湛 任务 列表 


2012=12=21 


| 2012-12-28 


家 中 有 事 


图 7-10 ”请 假 (普通 表 单 ) 的 申请 页 面 
在 点 击 图 7-10 的 “启动 流程 ”按钮 后 ， 将 提交 表单 至 “chapter7/leave/start” ， 对 应 的 Controller 见 代码 清单 7-17。 


代码 清单 7-17 “请假 流程 的 Controller 


GControlLler 
QRequestMapping (value = "/chapter7/leave") 
public class LeaveController { 

@Autowired 

private LeaveWorkflowService leaveService; 

QRequestMapping (value = "start", method = RequestMethod.POST) 
public String startWorkflow (Leave leave, HttpSession session, #1 
RedirectAttributes redirectAttributes) { 

User user = UserUtil.getUserFromSession (session); 


Map<String, Object> variables = new HashMap<String, Object>(); #2 
ProcessInstance processInstance = leaveService 
.StartWorkflow (leave, user.getId(), variables); #3 
redirectAttributes.addFlashAttribute ("message"，" 流 程 已 启动 ， 流 程 ID: " 
+ ProcessInstance .getId() ) 


在 代码 清单 7-17 的 #1 处 ， 第 一 个 参数 是 “leave” (Spring MVC 会 根据 表单 的 内 容 自动 封装 对 象 ) ; 在 #2 处 创建 一 个 Map 对 象 来 设置 启动 流程 的 变量 集合 ， 此 处 没有 变量 ， 所 以 没有 设置 值 。 
7.5.3 ”任务 读 取 


和 第 6 章 的 例子 一 样 ， 在 流程 启动 之 后 需要 办 理 任务 ， 所 以 需要 一 个 任务 列表 读 取 当 前 人 的 待 办 任务 。 当 然 在 第 6 章 我 们 已 经 设计 了 一 个 任务 列表 ， 可 以 胜任 读 取 待 办 任务 的 功能 ,但 是 目前 的 需求 不 能 
满足 普通 表单 的 要 求 了 ， 图 7-11 才 是 最 终 想 要 的 结果 。 


这 就 要 求 要 把 请 假 实 体 和 任务 对 象 相关 联 ， 也 只 有 这 样 才能 输出 图 7-11 这 样 的 列表 ， 可 以 很 清楚 地 了 解 一 条 任务 的 业务 信息 。 


aetwiti Explorer 青 首 页 请 候 【普通 去 单 ) = 强 企 务 列 去 HH 里 Kermit Miaorkermit 


请 假 申 请 


申请 人 型 请 候 时 间 请 候 原 因 | 任务 ID ”任务 名 称 流程 实例 ID ”流程 定 兴 ID 任务 创建 时 间 


Kerrmit 公休 2012-12-2109:10:00.0 至 家 中 有 事 ”105 部 门 领导 审批 101 leave:1 4 Thu Deec 20 22.06:25 GST 2012 
2012-12-28 09:00:00.0 


图 7-11 待 办 任务 列表 综合 业务 和 任务 信息 


在 第 6 章 任务 列表 查询 的 基础 上 稍 加 改造 即 可 得 到 图 7-11 的 任务 列表 。 在 代码 清单 6-10 中 已 经 实现 了 任务 的 读 取 ， 我 们 只 要 在 查询 完 所 有 任务 之 后 再 根据 启动 流程 时 传 入 的 业务 ID 查 询 请 假 记录 并 关联 
两 者 即 可 。 


代码 清单 7-18 在 代码 清单 6-10 的 基础 上 添加 了 一 段 代码 ， 用 来 根据 流程 数据 的 业务 ID 查询 关联 的 业务 对 象 。 


代码 清单 7-18 关联 读 取 业务 与 任务 数据 


public class LeaveWorkflowService { 
QTransactional (readonly = true) 
public List<Leave> findTodoTasks (String userId) { 
// 省 略 了 查询 任务 的 代码 ， 参 加 代码 清单 6-10 
// 根据 流程 的 业务 ID 查询 实体 并 关联 
for (Task task : 七 aSKS) { 
String ProcessInstanceId = task.getProcessInstanceld(); 
ProcessInstance ProcessInstance = runtimeService.createProcess] etLaneeOuery) 
.DrocessInstanceId (DrocessInstanceId) .singleResult () ; 
String businessKey = processInstance.getBusinessKey(); // 获取 启动 流程 时 的 业务 Key 
Leave leave = leaveManager.get (new Long (businessKey)); 
leave.setTask (task); ”// 在 Leave 类 中 添加 了 task 属 性 的 getter 和 setter 
results.add (leave); 
} 
return results; 
} 
} 


对 应 的 LeaveController 类 也 添加 了 一 个 读 取 任务 列表 的 方法 ， 见 代码 清单 7-19。 


代码 清单 7-19 ”向 请 假 流程 的 Controller 添 加 读 取 任务 列表 的 方法 


@QController 
@RequestMapping (Value = = "/chapter7/leave") 
public class LeaveController { 
@Autowired 
private LeaveWorkflowService leaveService; 
QRequestMapping (value = "task/list") 
public ModelAndView taskList (HttpSession session) { 
ModelAndView mav = new ModelAndView("/chapter7/leave/leave-task-list"); 
String UserId = UserUtil.getUserFromSession(session) .getIqd(); 
List<Leave> results = leaveService.findTodoTasks (userId); 
mav.addobject ("records", results); 
return mav; 


7.5.4 ”任务 办 理 


任务 办 理 页 面 和 请 假 申 请 一 样 需 要 针对 每 个 任务 设置 不 同 的 表单 ， 和 外 置 表单 一 样 ， 每 一 个 任务 都 设置 了 不 同 的 formkey 属 性 ， 在 任务 办 理 时 可 以 动态 获取 。 


使 用 普通 表单 也 是 类 似 的 原理 ， 首 先 针 对 每 个 任务 设计 好 对 应 的 表单 及 业务 逻辑 处 理 ， 然 后 单 击 图 7-11 中 的 “办 理 ” 按 钮 页 面 跳 转 到 当前 要 办 理 的 任务 的 对 应 页 面 (根据 流程 定义 文件 中 的 用 户 任务 ID 
属性 ) ， 如 此 就 可 以 和 外 置 表单 一 样 动态 选择 表单 。 


图 7-12 的 目录 结构 清楚 地 展示 了 根据 任务 ID 属 性 命名 的 JSP 文 件 。 


闻 | views 遍 | chapter5 曾 | leave leave-apply.jsp 
辐 spring-mvc.xml 让 | chapter6 J clist.i 
web.xml 国 chapter7 task-deptLeaderVerify.jsp 


惫 | main 按 照 任务 上 属性 , task-hrverify.jsp 


task-modifyApply.jsp 


Gp) 命名 名 交 件 本 task-reportBack.jsp 


根据 任务 ID 属性 命名 JSP 文 件 


图 7-12 请假 流程 ( 首 通 表单 ) 目录 结构 
在 图 7-12 中 ， 加 边框 部 分 以 “task-” 开 头 的 文件 就 是 针对 不 同 的 用 户 任务 定制 的 显示 内 容 ， 当 办 理 任务 时 ， 请 求 Spring MVC 的 Controller (或 者 Struts2 的 Action 等 ) 动态 返回 视图 的 名 称 
(以 “task-” 开 头 或 者 自 定 义 的 一 个 规则 ) 。 


代码 清单 7-20 在 LeaveController 中 添加 了 一 个 方法 “showTaskView”， 实 现 了 动态 返回 视图 的 功能 ， 并 在 视图 对 象 中 包含 了 请 假 实 体 及 任务 对 象 。 


代码 清单 7-20 “请假 流程 一 一 动态 显示 任务 表单 


@QRequestMapping (value = "task/view/{taskId}") 
public ModelAndView showTaskView (QPathVariable ("taskId") String taskId) { 
Task task = taskService.createTaskQuery() .taskId (taskId) .singleResult ();} 
// 读 取 流 程 实例 对 象 并 获取 启动 流程 时 传 入 的 pusinessKey 属 性 
ProcessInstance processInstance = runtimeService.createProcessInstanceQuery () 
.DrocessInstanceId (task.getProcessInstancelId();) .singleResult ();，; 
Leave leave = leaveManager.get (new Long (processInstance.getBusinessKey ())); 
ModelAndView mav = new ModelAndView( // 动态 拼接 视图 名 称 
"/chapter7/leave/task-" + task.getTaskDefinitionKey ()); 


mav.addOobject ("leave", leave); // 设置 leave 对 象 ， 可 以 在 视图 中 获取 属性 
mav.addobject ("task", task); // 设置 task 对 象 ， 在 视图 中 可 以 读 取 任务 相关 属性 


return mav; 


单 击 如 图 7-10 中 的 “办 理 ” 按 钮 后 页 面 跳 转 请 求 了 代码 清单 7-20 的 处 理 方法 ， 最 后 页 面 跳 转 至 “task-deptLeaderVerifyjsp”， 然 后 显示 如 图 7-13 所 示 的 办 理 界面 。 


Kerrmit 
2012-12-23 01:52':45,989 
么 怀 

开始 时 间 2012-=12-=-21 09:00:00,0 


结束 时 间 | :012-12-28 T150000 


请 假 原因 : 。 案 中 有 事 
审批 意见 : | 同意 


图 7-13 ”请 假 流程 的 “部 门 领导 审批 ”节点 办 理 界面 


在 流程 定义 文件 中 ， 完 成 “部 门 领导 审批 ”用 户 任务 需要 经 过 一 个 排他 分 支 (4.4.1 节 ) 的 ,领导 同 意 申请 时 的 条 件 为 “${deptLeaderApproved}”， 不 同意 时 的 条 件 
为 “${! deptLeaderApproved}j”， 由 7.3 节 获取 的 对 表达 式 的 理解 可 以 知道 ， 当 完成 此 任务 时 需要 传 入 一 个 名 称 为 “deptLeaderApproved”、 类 型 为 Boolean (布尔 型 ) 的 变量 。 第 6 章 的 条 件 判断 表达 
式 根据 一 个 字符 串 进 行 比较 “${deptLeaderApproved==′ true ” ， 所 以 deptLeaderApproved 的 类 型 应 该 为 String， 但 是 本 节 要 求 使 用 Boolean， 因 此 在 任务 完成 时 需要 进行 类 型 转换 。 如 果 完 成 任务 
时 涉及 更 新 业务 实体 的 属性 ， 还 要 保证 字段 与 实体 的 属性 不 冲突 (有 可 能 表单 的 字段 属性 名 称 相同 ) 。 代 码 清单 7-21 针 对 普通 表单 的 任务 完成 做 了 简单 的 实现 。 


普通 表单 任务 完成 方法 实现 


代码 清单 7-21 ”请 假 流程 


GReauestMapping (value = "task/complete/{id}") 
public String complete (GPathVariable("id") String taskId, QRequestParam(value = "saveEntity", required = false) String saveEntity, 
QModelAttribute ("preloadLeave") Leave leave, RedirectAttributes redirectAttributes) { 

boolean saveEntityBoolean = BooleanUtils.toBoolean (saveEntity); // 是 否 更 新 业务 实体 
Map<String, Object> variables = new HashMap<String, Object>(); #1-S 
Enumeration<String> parameterNames = request.getParameterNames (); 
try { 

while (parameterNames.hasMoreElements()) { 
String parameterName = (String) parameterNames.nextElement () ， 
if (parameterName.startsWith("p ")) { 

// 参数 结构 ，p_B_name，pPp 为 参数 的 前 级 ，B 为 类 型 ，name 为 属性 名 称 
String[] parameter = parameterName.split(™ "); 


if (parameter.length == 3) { 


String paramValue = request.getParameter (parameterName); // 默认 为 字符 型 
Object value = paramValue; 

f _ (Parameter[1] .equals("B")) { // 针对 Boolean 类 型 进行 处 理 
Value = BooleanUtils.toBoolean (paramValue); 

} else if (Parameter[1] .equals ("DT")) { // 针对 日 期 类 型 进行 处 理 
SimpleDateFormat sdf = new SimpleDateFormat ("yyyy-MM-dd HH:mm"); 
value = sdf.parse (paramValue); 


Ebs 


一 


} 
variables.put (parameter[2], value); 
} 
} 
} #1-E 
JeaveService.complete (leave, saveEntityBoolean, taskId, variables); #2 
redirectAttributes.addFlashAttripbute ("message", "任务 已 完成 ")， 
} catch (Exception e) { 
logger.error ("error on complete task {}, variables={}", new Object [] { taskId, variables, ee }); 
request .setAttribute ("error",， "完成 任务 失败 ") ; 


} 
return "redirect:/chapter7/leave/task/list"; 
} 
@Service 
GTransactional 
public class LeaveWorkflowService 1{ 
// 任务 完成 时 通过 saveEntity 判 断 是 否 保存 leave 对 象 
public void complete (Leave leave, Boolean SaveEntity String taskId, Map<String, Object> variables) 
{ 
if (saveEntity) { 
leaveManager .save (leave); 
} 


taskService.complete (taskId, variables); 


代码 清单 7-21 先 在 #1 处 根据 一 个 自 定义 的 规则 判断 来 自前 端的 请 求 参数 ， 如 果 和 预期 规则 相 匹 配 ， 则 将 其 加 入 到 任务 完成 时 的 变量 集合 中 ， 对 应 地 ， 在 JsP 中 设置 了 根据 变量 规则 定义 的 属性 名 称 。 


<label for="deptLeaderApproved"> 审 批 意见 : </label> 
<div class="controls"> 
<select name="p B deptLeaderApproved" id="deptLeaderApproved"> 
<option value="true"> 同 意 </option> 
<option value="false"> 拒 绝 </option> 
</select> 
</div> 


代码 清单 7-21 在 #2 处 调用 LeaveWorkflowService 类 的 complete 方 法 ， 并 且 根 据 变量 saveEntity 的 状态 判定 是 否 需要 更 新 实体 来 避免 多 余 的 数据 库 Update 操 作 。 


对 于 用 户 任务 “部 门 领导 审批 ”和 “人 事 审批 ”不 需要 更 新 业务 实体 ， 但 是 对 于 “调整 申请 ”任务 就 需要 在 任务 完成 的 同时 更 新 业务 实体 ， 办 理 界面 如 图 7-14 所 示 。 


2012-12-21 ] U240 


2012-12-28 ] O240 


冢 中 有 事 


是 否 继 续 申 请 : 


图 7-14 ”请 假 流程 一 普通 表单 的 “调整 申请 ”节点 办 理 界 面 


从 代码 清单 7-21 中 可 以 看 出 ， 如 果 变 量 “saveEntity” 为 “true”， 那 么 可 以 把 表单 的 内 容 在 任务 完成 之 前 更 新 ， 并 且 因 为 “LeaveWorkflowService” 是 受 事务 控制 的 (通过 注解 @Transactional 标 
记 ) ， 所 以 保存 实体 和 任务 完成 具有 事务 的 一 致 性 。 我 们 可 以 在 展示 层 的 “task-modifyApplyjsp” 的 表单 中 添加 一 个 隐藏 域 来 设置 saveEntity 的 值 。 


<input type="hidden" name="saveEntity" Value="true" /> 


通过 以 上 代码 完成 任务 “部 门 经 理 审批 ”以 及 “人 事 审批 ”之 后 ， 任 务 回 归 到 申请 人 ， 办 理 界面 如 图 7-15 所 示 。 


申请 人 ， merrmit 
申请 时 间 : 2012=12=23 0132:45 989 


请 假 类 型 ， 公休 
开始 时 间 : <U12-12-21 02.40:00.0 


结束 时 间 ， 2012-12-<8 0z2:40:00.0 


请 假 原 国 : 家 中 有 事 


买 际 开始 时 间 ; 2012-12-21 


实际 结束 时 间 : 2012-12-28 


”完成 任 筋 


图 7-15 ”请 假 流 程 一 一 普通 表单 “销假 ”办 理 界 面 


图 7-15 中 的 “实际 开始 时 间 ” 和 “实际 结束 时 间 ” 字 上段 属 于 Leave 实 体 ， 所 以 在 任务 完成 时 需要 更 新 实体 ， 不 过 在 用 户 任务 “调整 申请 ”中 已 经 演示 过 了 ， 所 以 我 们 利用 另外 一 种 方法 来 实现 任务 监听 


在 本 例 的 流程 定义 文件 的 “销假 ”任务 中 添加 一 个 “complete” 事 件 类 型 的 任务 监听 器 ， 当 任务 完成 时 把 页 面 传递 的 变量 更 新 到 Leave 实 体 。 


<userTask id="reportBack" name=" 销 假 " activiti:assignee="${applyUserId}"> 
<extensionElements> 
<activiti:taskListener event="complete" 
delegateExpression="$ {reportBackEndProcessor}"/> 
</extensionElements> 
</userTask> 


代码 清单 7-22 列 出 了 “销假 ”任务 的 完成 时 监听 器 ， 可 以 根据 流程 变量 更 新 Leave 实 体 并 持久 化 ， 当 然 为 了 统一 事务 管理 需要 使 用 Spring 代 理 。 


代码 清单 7-22 ”请假 流程 一 一 普通 表单 中 销假 任务 完成 监听 器 


@Component 
@Transactional 
public class ReportBackEndProcessor implements TaskListener { 
@Autowired 
LeaveManager leaveManager; 
public void notify(DelegateTask delegateTask) { 
String businessKey = delegateTask.getExecution() .getProcessBusinessKey () ， 
Leave leave = leaveManager.get (new Long (businessKey)); 
Object realityStartTime = delegateTask.getVariable ("realityStartTime");} 
lJeave.setRealityStartTime( (Date) realityStartTime); 


Object realityEndTime = delegateTask.getVariable ("realityEndTime");}; 
leave.setRealityEndTime ( (Date) realityEndTime); 
leaveManager .save (leave); 


至 此 一 个 基于 Spring 使 用 普通 表单 ， 并 且 业 务 和 流程 数据 库 分 离 的 应 用 告 一 段落 ， 其 中 涉及 了 表达 式 、 监 听 器 、 事 务 统一 管理 。 


营 女 
ES 


7.6 ”使 用 Spring 注 解 初始 化 3 


以 上 内 容 都 是 以 XML 方式 配置 引擎 ， 不 过 目前 一 部 分 开 友 人 员 偏 向 于 全 注解 的 编程 习惯 ， 以 及 推崇 “约定 优 于 配置 ”的 思想 ， 所 以 Spring 3.0 以 及 spring 4.0 版 本 都 强化 了 注解 的 作用 ， 本 节 将 介绍 如 何 


使 用 注解 的 方式 初始 化 引擎。 


7.6.1 使 用 @EnableActiviti 注 解 


在 Spring 3.0 中 加 入 了 很 多 有 用 的 注解 ， 使 用 全 注解 可 以 初始 化 Spring 上 下 文 对 象 (ApplicationContext) 或 者 注入 Bean。Spring 团 队 的 Josh Long 从 Activiti 创 立 开 始 就 一 直 致力 于 如 何 让 Activiti 与 
Spring 更 完美 的 结合 ， 前 面 章节 介绍 了 如 何 通过 XM 方式 配置 引擎 参数 并 初始 化 引擎 ， 本 节 将 介绍 如 何 使 用 Spring 注解 初始 化 流程 引擎 并 注入 service 接口 。 


Spring 的 @Confisuration 注 解 可 以 定义 在 一 个 类 上 ， 表 示 这 个 类 被 用 做 配置 对 象 。 有 关 该 注解 的 详细 使 用 方法 可 参看 Spring 的 用 户 手册 或 者 API 文 要 ， 其 中 均 有 详细 介绍 。activiti-spring 模 块 默认 提供 了 
基于 注解 的 实现 类 ActivitiConfigutation ， 可 以 在 一 个 类 上 标记 @ Confieutration 和 @EnableActivit 注 解 来 启用 该 类 初始 化 引 | 警 ， 可 以 创建 一 个 AnnotationCo nfigApplicationContext 对 象 获取 3 | 警 的 Service 接 
口 ， 具 体 的 代码 见 代 码 清单 7-23 所 示 。 


代码 清单 7-23 ”使 用 Spring 注解 初始 化 引擎 并 注入 Bean 


public class InitProcessEngineBySpringAnnotation { 
QConfiguration // Spring 的 注解 
QEnableActiviti // activiti-spring 模 块 的 注解 #1 
public static class SpringAnnotationConfiguration { 
@Bean // 自 定义 数据 源 
public DataSource dataSource() throws ClassNotFoundException { #2 
SimpleDriverDataSource ds = new SimpleDriverDataSource(); 
ds.setDriverClass ( (Class<? extends Driver>) Class.forName ("org.h2.Driver")); 
ds.setUrl ("jdbc:h2:mem:aia-chapter7;DB CLOSE DELAY=1000"); 
ds.setUsername ("sa™"); 
ds.setPassword(™"™"); 
return ds; 


} 
} 


public static void main(String[] args) { 


AnnotationConfigApplicationContext ctx = 

new AnnotationConfigApplicationContext (); #3-1 
ctx.register (SpringAnnotationConfiguration.class); 
ctx.refresh(); #3-2 

// 验证 引擎 是 否 成 功 初始 化 

assertNotNull (ctx.getBean (ProcessEngine.class)); #4-1 
assertNotNull (ctx.getBean (RuntimeService.class)); 
assertNotNull (ctx.getBean (TaskService.class)); 
assertNotNull (ctx.getBean (HistoryService.class)); 
assertNotNull (ctx.getBean (RepositoryService.class)); 
assertNotNull (ctx.getBean (ManagementService.class)); 
assertNotNull (ctx.getBean (FormService.class)); #4-2 


代码 清单 7-23 中 #1 处 定义 了 一 个 引擎 配置 类 SpringAnnotationConfiguration， 并 使 用 @Configuration 和 @EnableActiviti 注 解 标记 。#2 处 的 dataSource0 方 法 返回 一 个 数据 源 对 象 ， 该 方法 使 用 了 @ Bean 
注解 标记 ， 意 思 是 指定 引擎 配置 对 象 的 数据 源 需要 从 该 方法 获取 。 需 要 特别 注意 的 是 ， 如 果 @Bean 注 解 没有 指定 name 属 性 ， 那 么 方法 名 必须 与 配置 对 象 的 属性 名 称 保持 一 致 ， 当 然 也 可 以 通过 
@Bean(name="dataSource") 来 声明 ， 该 方法 会 返回 一 个 名 称 为 “dataSource” 的 Bean 对 象 (此 时 方法 名 可 以 不 与 引擎 配置 对 象 的 属性 一 致 ) 。 


在 #3 处 创建 一 个 AnnotationConfigApplicationContext 对 象 并 注册 #1 处 标记 的 配置 对 象 ， 通 过 刷新 上 下 文 对 象 来 扫描 SpringAnnotationConfiguration 类 中 定义 的 Bean 对 象 。 最 后 在 #4 处 从 上 下 文 
对 象 中 获取 引擎 的 Service 接 口 。 


7.6.2 ”使 用 Spring Boot 初 始 化 引擎 


Maven 工 具 遵 循 “ 约 定 优 于 配置 ”的 思想 规定 了 项 目 目录 的 结构 ，2014 年 Spring 团队 发 布 的 Spring Boot 项 目 也 正 是 借鉴 了 “约定 优 于 配置 ”的 思想 。 基 于 Spring Boot 可 以 快速 创建 Spring 应 用 或 者 
服务 。 


和 上 一 节 介 绍 的 注解 方式 类 似 ， 在 初始 化 Spring 时 均 有 默认 值 ， 当 然 也 可 以 履 盖 配置 参数 。 基 于 Spring Boot 的 初始 化 不 用 关心 任何 繁琐 的 XML 配置 ， 全 部 使 用 注解 标记 ， 并 且 可 以 不 依赖 外 部 容器 的 
情况 下 创建 独立 的 Java 应 用 或 者 Web 应 用 。 


USGr 


Spring Boot 


图 7-16” ”Spring Boot 在 Spring 生 态 中 的 位 置 


图 7-16 明 显 地 说 明了 Spring Boot 的 作用 及 其 在 Spring 生态 中 的 位 置 。 
在 Activiti 5.16 版 本 中 也 添加 了 对 Spring Boot 的 支持 ， 可 以 更 方便 地 通过 Spring 初始 化 引擎 以 及 获取 Service 接 口 对 象 。 代 码 清 单 7-24 列 出 了 使 用 Spring Boot 注 解 定义 的 引擎 配置 ， 代 码 清单 7-24 的 类 
在 chapter7-spring-boot 项 目 中 可 以 找到 。 


代码 清单 7-24 ”使 用 Spring Boot 注 解 初始 化 引擎 并 注入 Bean 


public class ActivitiWwithSpringBootApplication { 
@QConfiguration 
@QComponentScan 

QEnableAutoConfiguration // Spring Boot 注 解 拉 
public static class SpringBootConfiguration { 


La 
// 这 里 可 以 用 方法 设置 引擎 的 配置 属性 


public static void main (String[] args) throws Exception { 

// 启动 应 用 2 

ApplicationContext ctx = SpringApplication.run(SpringBootConfiguration.class, args); 
assertNotNull (ctx.getBean (RuntimeService.class)); 


} 


代码 清单 7-24 的 #1 处 使 用 @EnableAutoConfiguration 注 解 声明 启用 自动 配置 功能 ， 由 于 Activiti 的 spring-boot 模 块 中 已 经 内 置 了 支持 Spring Boot 的 配置 类 并 标注 了 相应 的 注解 (配置 类 名 称 为 
ProcessEngineAutoConfiguration) ， 所 以 当 通 过 #2 处 的 代码 启动 应 用 时 Spring Boot 会 扫描 并 执行 引擎 配置 对 象 的 初始 化 动作 。 


图 7-17 列 出 了 chapter7-spring-boot 模 块 的 目录 结构 ， 从 图 中 可 以 看 出 在 resources/processes 目 录 中 有 一 个 名 称 为 “simpleProcess.bpmn20.xml” 的 文件 。activiti-spring-boot 模 块 在 初始 化 时 会 
扫描 该 目录 中 扩展 名 为 “*.bpmn20.xml” 的 文件 并 部 署 到 引擎 。 


问 http:// 
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图 7-17 chapter7-spring-boot 模 块 的 目录 结构 
图 7-17 中 的 ActivitiController 类 是 Spring MVC 的 一 个 控制 器 ， 提 供 了 读 取 流程 定义 、 启 动 流程 、 查 询 任务 、 完 成 任务 的 简单 功能 ， 具体 的 实现 代码 可 自行 查看 源码 。 


运行 代码 清单 7-24 中 的 Java 类 后 通过 Spring Boot 的 内 骨 Web 容 器 (Tomcat) 启动 了 一 个 Web 服 务 ， 相 关 的 Maven 依 赖 可 参看 chapter7-spring-boot 模 块 中 pom.xml 文 件 中 的 定义 ， 访 
localhost:8080 即 可 看 到 如 图 7-18 所 示 的 界面 。 


Ex 


ee 3 localhost: R080 /activiti/processes 


流程 定义 列表 


simpleProcess:1:4 simpleProcess 简单 任务 


图 7-18 ”自动 部 署 的 流程 定义 


通过 Spring Boot 注 解 初始 化 引 警 后 在 Controller 中 可 以 通过 注解 方式 注入 引擎 的 Service 接 口 ， 当 然 也 可 以 在 配置 对 象 (代码 清单 7-24 中 #1 处 的 SpringBootConfiguration 类 ) 中 履 盖 默认 配置 参数 ， 
相 比 XML 方式 更 加 的 灵活 。 


7.7 ”CDI 模块 


除了 使 用 Spring 提 供 的 注解 实现 依赖 注入 之 外 ， 在 JAVA EE6 版 本 中 添加 的 上 下 文 和 依赖 注入 (Contexts and Dependency Injection for Java EE， 简 称 CDI) 标准 允许 开发 人 员 在 JAVA EE 平台 中 使 用 
CDI 的 注解 实现 上 下 文 描述 和 依赖 注入 等 扩展 功能 。CDI 在 JSR-299 中 有 详细 的 描述 ， 其 中 依赖 注入 使 用 了 JSR-330 (Dependency Injection for Java， 简 称 DI) 规范 ， 该 规范 也 被 Spring、Guice 等 第 三 方 
框架 所 兼容 。 


CDI 的 实现 方式 有 多 种 ， 例 如 JBoss Weld、Cauho CanDI、Apache OpenWebBeans， 使 用 JAVA EE 的 CDI 的 注解 描述 Bean 就 可 以 在 不 同 的 实现 平台 之 间 实 现 移植 。 
人 证 示 Activiti CDI 模 块 仅 在 JBoss Weld 环 境 中 进行 过 测试 ， 不 同 的 实现 平台 之 间 可 能 有 差异 。 
7.7.1 ”启动 示例 


本 章 使 用 的 容器 版 本 为 JBoss As 7.1.1， 在 本 章 示例 (chapter7-cdi) 的 pom.xml 文 件 中 定义 了 “jboss.home” 属性 。 在 运行 本 章 示 例 之 前 先 更 改 上 oss 的 目录 。 运 行 本 章 示 例 的 顺序 如 下 。 

. 启动 JBoss 容器 : 执行 JBoss 容器 中 的 bin/standalone.bat (Windows 平 台 ) 或 者 bin/standalone.sh (Linux 或 者 UNIX 平 台 ) 。 

部署 示例 到 JBoss: 在 示例 代码 根 目录 执行 hvn jboss-as:deploy 命 令 ， 使 用 了 JBoss 的 Maven 插 件 jboss-as-maven-plugin ( 先 修改 pom.xml 文 件 中 的 jboss.home 属 性 值 为 本 地 JBoss 的 根 目 录 路 径 ) 。 
. 访问 示例 : 在 浏览 器 打开 http://localhost:8080/chapter7-cdi。 


本 节 示例 代码 中 使 用 的 视图 技术 是 JSF， 同 时 为 了 演示 在 页 面 中 添加 了 三 个 菜单 链接 ， 如 图 7-19 所 示 。 接 下 来 会 一 讲解 如 何 使 用 Activiti CDI 模 块 提供 的 功能 操作 流程 数据 . 


二 【 | 前 localhost: SOBO /chapter?7-cdilindex .xhtml 


《Activiti 实 成 》 第 7 登 -CDI 示 例 


菜单 列表 


引擎 属性 


{next.dbid=25301, schema.history=create($.16). schema .version=S.16} 


图 7-19 ” ”CDI 示例 首页 


7.7.2 ”引擎 配置 与 流程 定义 


为 了 演示 方便 本 节 示 例 使 用 JBoss 中 用 于 演示 的 内 置 数 据 源 (内 存 模式 的 H2 数 据 库 ) 及 容器 提供 的 事务 管理 器 。 下 面 列 出 了 本 节 示 例 的 Activit 配 置 文件 (activiti.cfg.xml) 。 


<!-- JTA 事 务 管理 器 --> 

<bean id="transactionManager" 

class="org.springframework.jndi.JndiObjectFactoryBean"> 
<property name="jndiName" // JBoss 内 置 的 事务 管理 器 

value="java:jboss/TransactionManager"/ > 
<property name="resourceRef" value="true" /> 

</bean> 


<!-- 流程 引擎 配置 对 象 --> 
<bean id="processEngineConfiguration" 
class="org.activiti.cdi 
.CdiJtaProcessEngineConfiguration"> 
<property name="dataSourceJndiName" 
value="java:jboss/datasources/ExampleDS" /> // 内 置 的 数据 源 
<property name="databaseType" value="h2" /> 
<property name="transactionManager" ref="transactionManager" /> 
<!-- 打开 外 部 事务 管理 器 开关 --> 
<property name="transactionsExternallyManaged" 
value="true" /> 
<property name="databaseSchemaUpdate" value="true" /> 
</bean> 


对 于 以 上 配置 有 几 点 需要 说 明 ， 
. 引擎 配置 对 象 : 使 用 activiti-cdi 模 块 的 org.activiti.cdi.CdiJtaProcessEngineConfiguration。 
* 数据 源 : 通过 JNDI 方 式 从 容器 获取 。 


. 事务 管理 器 : 通过 JNDI 方 式 从 容器 获取 JTA 事 务 管理 器 (分 布 式 事务 管理 ) ，“java:jboss/TransactionManager” 为 J]Boss 内 置 的 事务 管理 器 ， 并 且 设 置 引 掌 的 “transactions- 


ExternallyManaged” 属 性 为 “ttue”， 告 知 引 擎 事务 由 “transactionManagef ”属性 引用 的 bean 作 为 引擎 的 事务 管理 器 。 


Activiti CDI 模 块 与 Activiti Spring 模 块 有 一 个 类 似 的 功能 一 一 自动 部 署 流程 : 在 源码 的 资源 根 目录 中 添加 名 称 为 “processes.xml” 的 文件 并 在 该 文件 中 加 入 需要 部 署 的 流程 文件 路 径 ， 在 启动 引擎 并 初 
始 化 Activiti 引 警 时 会 自动 把 该 文件 中 定义 的 流程 部 署 到 引擎。 相关 配置 代码 如 下 : 


<?xml Version="1.0" encoding="utf-8" ?> 
<!-- 自动 部 署 的 流程 文件 --> 
<processes> 

<process resource="diagrams/leave.bpmn" /> 
</processes> 


所 以 ， 在 启动 chapter7-cdi 示 例 后 单 击 “ 流 程 定义 ”菜单 就 可 以 查询 到 如 图 7-20 所 示 的 页 面 ， 其 中 显示 了 已 经 部 署 到 引擎 的 流程 定义 列表 。 不 过 需要 注意 的 是 每 次 启动 应 用 时 引擎 都 会 部 署 
processes.xm| 文 件 中 配置 的 流程 文件 ， 所 以 建议 在 生产 环境 选择 手动 部 署 而 不 是 由 CDI 模 块 自动 部 署 。 


Pr 


| localhost:8080/chapter7-cdi/processList.xhtml 


Key 名称 版 本 操作 


leave 请假 流程 -CDI 1 


7.7.3 ”流程 定义 与 启动 


本 节 的 示例 流程 定义 使 用 了 外 值 表单 模式 ， 在 启动 节点 以 及 每 个 用 户 任务 上 用 activiti:formKey 属 性 定义 流程 的 表单 路 径 ， 相 关 配 置 如 下 : 


<process id="leave" name=" 请 假 流程 -CDI"> 
<startEvent id="starteventl" name="Start" 
activiti:initiator="applyUserld" 
activiti:formKey="leave-apply.xhtml"></startEvent> 
<userTask igd="deptLeaderAudit"” name=" 部 门 领导 审批 " 
activiti:assignee="deptLeader" 
activiti:formKey="form/deptLeaderAudit.xhtml"/> 
<userTask igd="modifyApply"” name=" 调 整 申请 " 
activiti:assignee="$ {applyUserId}" 
activiti:formKey="form/modifyApply.xhtml" /> 
<userTask id="hrAudit" name=" 人 事 审批 " 
activiti:assignee="hr" 
activiti:formKey="form/hrAudit.xhtml" /> 
<userTask id="reportBack"” name=" 销 假 " 
activiti:assignee="$ {applyUserId}" 
activiti:formKey="form/reportBack.xhtml"/> 


</process> 


以 上 流程 定义 片段 中 加 粗 部 分 为 任务 办 理 人 以 及 任务 表单 URL， 对 于 流程 中 的 排他 网 关 的 条 件 定义 也 与 前 面 章节 介绍 的 有 些 不 同 ， 例 如 判断 部 门 领 导 是 否 同意 的 条 件 为 : 


${!leave.isDeptLeaderApproved ()} 


其 中 leave 为 一 个 普通 的 Pojo 对 象 ， 该 对 象 的 属性 如 下 ， 特 别 的 是 在 该 类 上 标注 了 两 个 注解 ，@Named 注 解 可 以 通过 leave 获 取 到 该 类 的 实例 ，@BusinessProcessScoped 注 解 则 由 Activiti CDI 模 块 提 
供 ， 功 能 类 似 JAVA EE 的 @ConversationScoped 注 解 ， 可 以 把 该 对 象 绑 定 到 一 次 请 求 中 。 


GNamed 
BusinessProcessScoped 
public class Leave implements Serializable { 


// 业务 属性 


(ec 


private String startTime; 
private String endTime; 
private String reason; 

private String reallyStartTime; 


private String reallyEndTime; 

// 网 关 条 件 判断 属性 

private boolean reapply; 

private boolean deptLeaderApproved; 
private boolean hrApproved; 


A a 


读 取 流 程 定义 的 方式 与 以 往 没 有 差别 ， 只 不 过 使 用 了 JAVA EE 的 相关 技术 而 已 (例如 注入 、JSF 等 ) 。 下 面 的 代码 清单 列 出 了 ActivitiAction 类 中 读 取 流程 定义 的 代码 块 。 


@Inject // 注入 引擎 接口 

private RepositoryService repositoryService; 

@Produces 

QNamed ("processDefinitionList") 

public List<ProcessDefinition> getProcessDefinitionList() { 

return repositoryService 
.createProcessDefinitionQuery () .list (); 


上 面 的 方法 被 定义 成 一 个 Bean， 可 以 通过 名 称 “processDefinitionList” 调 用 ， 在 视图 文件 “processList.xhtml” 中 就 可 以 循环 流程 定义 集合 了 (结果 见 图 7-20) 。 相 关 代 码 如 下 : 


<h:dataTable value="#{processDefinitionList}" 
Var="process"> 

// 省 略 了 其 他 几 列 

<h:column> 

<f:facet name="header"> 操 作 </f:facet> 

<h:outputLink value="#{formService 

.getStartFormData (process.id) .formKkey}"> 
启动 


<f:param name="processDefinitionKey" 
value="#{process.key}"></f:param> 
</h:outputLink> 
</h:column> 
</h:dataTable> 


上 面 代码 清单 中 “h:outputLink” 部 分 的 加 粗 代码 是 重点 ， 从 Activiti 的 FormService 接 口中 获取 启动 流程 的 formKey 属 性 ， 从 而 获取 流程 文件 中 startEvent 标 签 的 “activiti:formKey” 属 性 定义 的 值 ， 
即 “leave-apply.xhtml”; 在 单 击 图 7-20 的 “启动 ”链接 后 页 面 跳 转 到 如 图 7-21 所 示 的 请 假 申 请 界面 。 


UL localhost:8080/chapter7-cdi/leave-apply.xhtml?process DefinitionKey=|eave 
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菜单 列表 请 假 申 


申请 人 : rate 夯 
请 假 开 始 时 间 : 

请 假 结束 : 

请 假 理由 : 


图 7-21 请 假 申 请 界面 


在 请 假 申请 文件 leave-apply.xhtml 中 把 输入 框 的 值 绑 定 到 Leave 对 象 的 属性 上 ， 这 样 当 单 击 图 7-21 的 “申请 ”按钮 后 容器 会 把 界面 填写 的 值 写 回 到 Leave 对 象 ， 有 关 界 面 的 定义 如 下 : 


< 七 工 > 


<td> 申 请 人 :</td> 


<h:inputText value="#{systemUser.userId}" /> 
</td> 
</tr> 
// http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15030/OEBPS/Text/... 省 略 了 其 他 的 业务 字段 定义 
<tr> 


<td></td> 
<td><h:commandButton value=" 申 请 " 
action="#{activitiCdiAction.startLeaveProcess ('102')}" 
/></Ld> 
/EE 


以 上 代码 中 的 systemUser 是 一 个 简单 的 Bean 对 象 ， 仪 提供 一 个 userld 属 性 来 模拟 真实 业务 系统 中 的 当前 用 户 。 


“申请 ”按钮 的 “action” 属性 为 当前 页 面 中 表单 的 action ， 作 用 是 启动 一 个 流程 ， 请 求 由 名 称 为 “activitiCdiAction” 的 startLeaveProcess 方 法 处 理 ， 相 关 代码 如 下 : 


GNamed 

public class ActivitiCdiAction { 
QProcessVariable String orgId; 

@Inject 

IdentityService identityService; 


@Inject 
private SystemUser systemUser; 
@StartProcess (value = "leave") 
public String startLeaveProcess (String orgId) { 
identityService 
.SetAuthenticatedUserId (SystemUser .getUserId () ) ; 
this.GrdIaQ = orglId; 
System.out .printlin ("流程 【请 假 】 启 动 " + orgId) ; 
return Us 


在 ActivitiCdiAction 中 分 别 注入 了 引擎 的 IdentityService 接 口 及 当前 用 户 对 象 ， 标 注 了 @ProcessVariable 注 解 的 属性 则 表示 在 流程 启动 时 需要 保存 的 变量 。 从 上 面 的 代码 清单 中 可 以 看 出 方法 
startLeaveProcess 接 口 的 orgld 参 数 赋值 给 了 成 员 变 量 orgld， 该 方法 上 标注 的 @StartProcess 注 解 用 来 声明 当 该 方法 被 调用 时 启动 一 个 KEY 为 “leave” 的 流程 ， 同 时 扫描 该 类 中 所 有 标注 了 
@ ProcessVariable 注 解 的 属性 作为 流程 变量 。 因 此 单 击 了 图 7-21 中 的 “申请 ”后 就 成 功 启 动 了 一 个 请 假 流 程 ， 可 以 在 待 办 任务 以 及 流程 变量 菜单 中 验证 。 


图 7- 22 展 示 了 启动 流程 后 的 流程 变量 列表 。 


流程 变量 列表 


擎 保存 了 三 个 变量 ， 其 中 applyUserld 为 申请 人 ID，orgld 为 部 门 ID (为 了 演示 这 里 固定 使 用 102 作 为 部 门 ID) ， 名 称 为 “leave” 的 变量 类 型 


从 图 7-22 中 可 以 看 出 ， 在 启动 流程 后 引 上 


为 “serializable” ， 是 一 个 对 象 类 型 。 正 因为 Leave 类 被 标注 了 @BusinessProcessScoped 注 解 所 以 才 会 作为 变量 保存 到 引擎 


需要 注意 的 是 在 使 用 @StartProcess 注 解 之 前 要 在 WEB-INF/beans.xml 文 件 中 添加 处 理 该 注解 的 拦截 器 StartProcessinterceptor， 该 拦截 器 由 Activiti CDI 模 块 提供 ， 配 置 拦截 器 的 相关 配置 如 下 ， 同 时 
也 包含 了 @CompleteTask 的 注解 拦截 器 ( 稍 后 会 介绍 ) 。 


<interceptors> 
<class>org.activiti.cdi.impl.annotation 
.StartProcessInterceptor</class> 
<class>org.activiti.cdi.impl.annotation 
.CompleteTaskInterceptor</class> 


</interceptors> 


StartProcessinterceptor 拦 截 器 会 判断 方法 上 是 否 被 标注 了 @StartProcess 注 解 ， 如 果 被 标注 了 ， 则 读 取 value 属 性 的 值 ， 然 后 调用 Activiti CDI 模 块 中 BusinessProcess 类 的 startProcessByKey 方 法 启 
动 流程 。 也 可 以 采用 在 业务 处 理 层 自 行 注入 BusinessProcess 对 象 调用 响应 的 方法 启动 流程 。 


启动 流程 的 方式 除了 使 用 @StartProcess 注 解 外 还 可 以 使 用 调用 BusinessProcess 的 方法 ,， 例 如， 图 7-21 中 “申请 ”的 action 可 以 这 样 写 : 


#{businessProcess.startProcessByKey (processDefinitionKey)} 


也 可 以 正常 启动 流程 ， 只 不 过 这 种 方式 不 能 传递 orgld 变 量 ， 所 以 一 般 情 况 下 不 会 使 用 这 种 方式 。 


7.7.4 ”任务 办 理 与 完成 


启动 流程 后 任务 到 达 “部门 领导 审批 ”节点 ， 该 节点 的 办 理 人 为 “deptLeader” (为 了 演示 方便 固定 了 该 任务 的 办 理 人 ) ， 单 击 “ 待 办 任务 ”菜单 项 ， 在 输入 框 中 输入 “deptLeader” 后 页 面 立即 读 


取 该 用 户 的 待 办 任务 列表 ， 如 图 7-23 所 示 。 


全 地位 pe localhost: 8080/chapter7-=cdl /taskList,xhtml 


竺 办 任务 列表 


根据 用 户 人 查询 竺 办 任务 
[可 选 : kafeim、 deptLeader、 hr) deptleader | 


任务 名 称 创建 时 间 ”描述 操作 
部 门 领导 审批 2014-08-03 04:29 办 理 


图 7-23 ”deptLeader 用 户 的 待 办 任务 列表 


在 taskList.xhtml 文 件 中 输出 任务 列表 的 部 分 代码 如 下 : 


<h:dataTable value="#{todoTaskList}" var="v task"> 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15030/0EBPS/Text/... 
<h:column> 
<f:facet name="header"> 操 作 </f:facet> 
<h:outputLink value="#{request.contextPath} 
0 60 
办 理 


<f:param name="taskId" 
value="#{v task.id}"></f:param> 
</h:outputLink> 加 
</h:column> 
</h:dataTable> 


在 以 上 代码 中 ，“ 办 理 ” 链 接 的 读 取 方 式 与 启动 流程 类 似 ， 获 取 任 务 的 formKey 属 性 并 与 上 下 文 路 径 拼 接 ， 所 以 在 点 击 “ 办 理 ” 链 接 后 页 面 跳 转 到 了 http://localhost:8080/chapter7- 
cdi/form/deptLeaderAudit.xhtml?taskld=13 页 面 ， 如 图 7-24 所 示 。 


> 人 加 localhost:8080 /chapter7-cdijform/deptLeaderAudit.xhtml?taskld= 13 


《Activiti 实 战 办 第 7 革 -CDI 示 例 


部 门 领导 审批 


请 假 开始 日 期 : 2014-07-07 09:00 
请 假 结 束 日 期 :2014-07-07 17:00 
请 假 原 因 : 。 ”公休 
同意 >? 加 

「 完成 任务 | 


图 7-24 ”任务 办 理 界 面 


查看 本 节 源 码 的 form/deptLeaderAudit.xhtml 文 件 可 以 看 到 如 下 的 代码 片段 : 


<f:metadata> 

<f:viewParam name="taskId" /> 
<!-- 办 理 任务 时 读 取 Task 对 象 并 开始 一 个 新 的 会 话 --> 
<f:event type="preRenderView" 
listener="#{businessProcess.startTask (taskId, true)}" /> 
</f:metadata> 
<h1l>#{task.name}</h1> 


<h:form> 
<table> 
// 省 略 了 部 门 tz 输 出 
< 七 工 > 
<td> 同 意 ? </td> 
<tqd> 
<h:selectBooleanCheckbox // 把 结果 保存 到 leave 
value="#{leave.deptLeaderApproved}" /></td> 
</tr> 
<tr> 
< 七 Q> 
<h:commandButton value=" 完 成 任务 " 
action="#{activitiCdiAction.completeTask()}" /> 
</td> 
</tr> 
</table> 
</h: form> 


以 上 代码 分 为 两 部 分 ， 第 一 部 分 (<fimetadata>) 获取 视图 的 taskld 参 数 ， 然 后 用 event 标 签 定义 一 个 页 面 来 展示 之 前 的 监听 器 ,调用 Activiti CDI 模 块 BusinessProcess 类 的 startTask 方 法 ， 该 方法 可 
以 从 引 警 读 取 一 个 任务 对 象 (Task) ， 该 方法 的 第 二 个 参数 为 true， 作 用 是 让 容器 开启 一 个 会 话 (Conversation) ， 这 样 可 以 把 读 取 到 的 Task 对 象 绑 定 到 本 次 会 话 中 ， 当 然 流程 变量 也 会 被 读 取 到 且 可 以 直 
接 调用 。 


二 部 分 (<h:form>) 则 用 来 展示 业务 信息 与 “完成 任务 ”按钮 ， 其 中 “同意 ? ”选项 的 值 被 绑 定 到 leave 对 象 的 deptLeaderApproved 属 性 上 (Boolean 类 型 ) ; 单 击 “ 完 成 任务 ”按钮 会 调用 
ActivitiCdiAction 类 的 completeTask 方 法 从 而 触发 任务 完成 动作 ， 任 务 完 成 和 启动 流程 类 似 ，Activiti CDI 模 块 也 提供 了 注解 ， 名 称 为 @CompleteTask， 使 用 该 注解 定义 的 方法 如 下 : 
QCompleteTask (endConversation = true) 


public String completeTask() { 
return "/taskList.xhtml"; 


} 


以 上 代码 中 的 completeTask 方 法 被 标注 了 @CompleteTask 注 解 ， 并 且 设 置 属性 endConversaton 为 true， 表 示 在 任务 完成 后 本 次 会 话 是 否 结束 ， 在 实际 应 用 中 可 以 根据 业务 的 不 同 决定 在 任务 完成 后 
是 否 要 结束 本 次 会 话 


当然 除了 使 用 注解 声明 方式 完成 任务 外 ， 还 可 以 调用 BusinessProcess 对 象 的 相应 方法 ， 在 “人 事 审批 ”节点 的 页 面 文件 hrAudit.xhtml 中 有 如 下 的 代码 ， 同 样 也 可 以 完成 任务 。 


<h:commandButton value=" 完 成 任务 " 
action="#{businessProcess.completeTask (true)}" /> 


7.7.5 ”事件 监听 


Activiti CDI 模 块 除 了 提供 启动 流程 、 完 成 任务 之 外 还 提供 了 事件 监听 方面 的 注解 ， 运 行 用 户 自 定 义 事件 处 理 器 ， 并 且 支 持 条 件 过 滤 ， 例 如 监听 任务 “部 门 领导 审批 ”的 创建 事件 可 以 用 以 下 代码 定义 事 
件 处 理 器 


public class ActivitiCdiEventListener { 
public void onStartActivityServicel ( 
QObserves QCreateTask ("deptLeaderAudit") 
BusinessProcessEvent businessProcessEvent) { 
System.out .println ("捕获 到 【部 门 领导 审批 】 的 事件 : " 
+ businessProcessEvent);} 


不 过 仅仅 定义 好 事件 处 理 器 还 不 够 ， 还 需要 在 引擎 配置 文件 中 添加 针对 CDI 的 事件 处 理 器 ， 该 处 理 器 由 Activiti CDI 模 块 提供 ， 相 关 配 置 如 下 : 


<property name="postBpmnParseHandlers"> 
<list> 
<bean class="org.activiti.cdi.impl.event 
.CdiEventSupportBpmnParseHandler" /> 


</list> 
</property> 


在 启动 流程 后 在 JBoss 控 制 台 就 可 以 看 到 如 下 的 输出 内 容 : 


[stdout] (http--127.0.0.1-8080-1) 捕获 到 【部 门 领导 审批 】 开 始 事件 : Event 'leave' ['create', deptLeaderAudit] 


Activiti CDI 模 块 提供 了 几 种 常用 的 事件 注解 ， 具 体 如 下 : 
. BusinessProcess， 启 动 流 程 

* CreateTask， 任 务 创 建 

. AssignTask， 任 务 分 配 办 理 人 

CompleteTask， 任 务 完 

: DeleteTask， 删 除 任 务 

StartActivity， 开 始 一 个 活动 

. EndActivity， 结 束 一 个 活动 


:TakeTransition，Flow 被 执行 时 


7.8 本章 小 结 


本 章 主 要 讲解 了 Activiti 与 各 种 不 同 的 容器 的 集成 ， 分 别 介绍 了 基于 Spring 的 XML 配置 方式 、 基 于 Spring 注解 配置 方式 、 基 于 Spring Boot 的 注解 方式 、 基 于 JAVA EE CDI 的 方式 。 这 几 种 集成 方式 各 不 
相同 ， 也 有 着 不 同 的 应 用 场景 。 


在 讲解 与 Spring 集成 时 主要 介绍 了 : 引擎 工矿、 表达 式 、 监 听 器 ， 以 及 综合 运用 。 其 中 引 警 工厂 、 表 达 式 、 监 听 器 先 从 默认 支持 讲解 ， 再 讲解 如 何 使 用 Spring 代理 实现 。Activiti 提 供 了 多 种 创建 引擎 航 
方式 ， 本 章 对 不 同 的 创建 方式 做 了 简单 介绍 ， 对 使 用 Spring 方式 创建 引擎 做 了 详细 的 介绍 ， 因 为 毕竟 目前 大 多 数 企 业 应 用 都 是 基于 Spring 的 。 


表达 式 与 监听 器 是 Activiti 中 比较 重要 的 一 部 分 内 容 ， 所 以 用 了 两 节 详 细 讲 解 两 者 如 何 使 用 ， 以 及 如 何 联合 起 来 使 用 ， 例 如 通过 监听 器 执行 一 个 表达 式 。 


7.5 节 综合 了 前 面 所 讲 内 容 实现 了 普通 表单 形式 的 请 假 流程 ， 既 补充 了 对 三 种 表单 (普通 表单 、 动 态 表单 、 外 置 表单 ) 中 普通 表单 的 介绍 ， 又 针对 Spring 如 何 做 到 统一 事务 管理 做 了 详细 介绍 ， 这 也 是 为 
什么 把 普通 表单 在 本 章 介绍 而 非 第 6 章 介绍 的 原因 。 


除了 传统 的 基于 XML 的 方式 配置 、 初 始 化 引擎 的 方式 之 外 还 可 以 通过 注解 的 方式 由 Spring、Sspring Boot、CDI 等 容器 来 扫描 指定 注解 ， 以 实现 初始 化 或 其 他 与 流程 相关 的 功能 。 


第 8 章 ”邮件 服务 


邮件 系统 可 以 说 是 每 个 企业 办 公 系 统 中 必 备 的 ， 利 用 现 有 的 邮件 资源 把 邮件 任务 加 入 到 流程 中 作为 其 中 一 个 环节 ， 例 如 ， 在 一 个 任务 创建 或 超时 之 后 发 送 邮 件 通知 员工 办 理 (如 果 企业 邮箱 支持 PUSH 
功能 就 可 以 即时 提醒 ) ; 在 一 些 客服 系统 中 会 由 客服 处 理 流程 ， 对 于 单 次 的 流程 办 理会 通过 邮件 通知 客户 ， 可 以 根据 业务 信息 及 预 设 的 模板 自动 创建 邮件 内 容 并 由 流程 引擎 发 送 通知 邮件 给 最 终 客户 。 


本 章 首先 介绍 Activiti 提 供 的 邮件 任务 (4.3.6 节 ) 的 使 用 方法 ， 再 把 邮件 任务 加 入 到 第 7 章 的 请 假 流 程 中 ， 在 审批 通过 之 后 发 送 通 知 邮件 ， 如 果 “销假 ”节点 超过 限制 时 间 ， 同 样 发 送 邮件 通知 用 户 。 


8.1 配置 与 测试 


8.1.1 搭建 邮件 系统 


邮件 系统 有 太 多 可 以 选择 了 ， 有 商业 的 、 开 源 的 ， 例 如 企业 常用 的 Postfix、zimbra、james 等 。 为 了 方便 讲解 ， 本 章 使 用 Apache 的 James (Java Apache Mail Enterprise Server) 作为 邮件 系统 ， 它 
是 Apache 的 子 项 目 之 一 ， 完 全 采用 Java 实 现 ， 支 持 SMTP\POP3 等 多 种 协议 ， 还 可 以 自行 扩展 。 可 以 从 http://james.apache.org/ 下 载 Jjames。 这 里 以 James 稳 定 版 (版 本 号 为 2.3.2) 为 例 来 介绍 邮件 系统 
的 搭建 。 


James 的 安装 方法 也 比较 简单 ， 把 下 载 的 压缩 包 解压 得 到 类 似 图 8-1 的 目录 结构 。 


Today 2:14 PM 
AUg 10, 2009 4:5] PM 
AUG 10, 2009 4:51 PM 
AUg 10, 2009 4:5] PM 
AUg 10, 2009 4:5] PM 
AUg 10, 2009 4:51 PM 
Today 2:14 PM 
Today 5:27 PM 
Today 8:14 PM 
Today 8:1]4 PM 


d= | 


mm 
Bb 
br” 
> 
b> 
bb- 
bp 
‘ee 
Bb 
py 


四 


图 8-1 James 的 目录 结构 


启动 James 可 以 通过 执行 bin 目 录 的 run.sh (Linux 或 者 UNIX 系 统 ) 和 run.bat (Windows 系 统 ) 脚本 来 完成 ， 不 过 在 运行 之 前 需要 修改 几 个 端口 号 的 参数 ， 因 为 有 些 操作 系统 在 启动 James 时 会 提示 
SMTP 或 其 他 协议 端口 分 配 权限 不 足 ， 所 以 需要 修改 James 的 端口 号 : 打开 james_home/apps/james/SAR-INF/config.xm 文 件 ， 修 改 该 文件 中 的 三 个 端口 号 (pop3server、smtpserver、nntpserver 中 
port 标 签 的 值 )， 保 存 文件 后 重新 启动 lames 服 务 。 


<pop3server enabled="true"> 

<port>110</port> 
</pop3server> 
<smtpserver enabled="true"> 
<port>25</port> 
</smtpserver> 
<nntpserver enabled="true"> 


<port>119</port> 
</nntpserver> 


为 了 满足 后 面 的 测试 需求 ， 这 里 把 smtp 协 议 的 端口 号 改 为 2025。 


通过 执行 bin 目 录 的 run 脚 本 显示 如 图 8-2 的 信息 ， 表 示 服 务 启动 成 功 。 


rootehy-mbp AMNsers/henryyan/mork/sources/aopache/James/james-2.3.2/bin ./run.sh 
Using PHOENIX_HOME: /Users/henryyan/work/sources/apache/james/jaomes-2.3.2 

Using PHOENIX_TMPDIR: /Users/henryyan/work/sources/apache/james/James-2.3.2/temp 
Using JAVA_HOME: /Library/Java/JavavirtualMachines/1.7.0.jdk/Contents/Home 
Running Phoenix: 


Phoenix 4.2 


James Mail Server 2.3.2 
Remote Manager Service started plain:4555 
POP3 Service started ploin:110 
SMTP Service started plain:2025 
NNTP Service started plain:119 
FetchMail Disabled 
图 8-2 James 启 动 成 功 
James 默 认 使 用 localhost 作 为 域名 ， 如 果 需 要 更 改 ， 可 以 在 config.xml| 文 件 中 修改 servername 标 签 的 值 。 


在 图 8-2 中 提示 了 “Remote Manager Service”， 意 思 是 可 以 通过 telnet 协 议 登 录 James 管 理 邮件 系统 ， 默 认 的 用 户 名 和 密码 为 : root 和 root。 如 图 8-3 所 示 ， 成 功 登录 到 了 James 后 台 。 


henryyanEhy-mbp ~ telnet localhost 4555 


Connected to Localhost. 
Escape character is “A] " 

AMES Remote Administration Tool 2.3.2 
Please enter your Logtn and password 
Login id: 
root 
Password: 
root 
Welcome root. HELP for a list of comands 


display this help 
listusers display existing accounts 
countusers display the number of existing accounts 
ndduser [username| [password]| add a new user 
verify [username] verify if specified user exist 
deluser [username)] delete existing user 
setpassword [username] [password] sets a USer 5 password 
setalias [user] [alias] locally forwards all email for user to "alias'" 
showalias [username)] shows a USer S current emalil alias 
unsetalias [user] Unmsets an alias for ‘User' 
setforwarding [username] [emailaddress] forwards a USser S email to another email address 
showforwarding [username] shows a User's Current email forwarding 
unsetforwarding [username] removes a forward 
USEP [Feposttorynmame | change to another user repository 
shutdown kills the current JVM (Cconvenient When James is run as a doemon) 
quit close connection 


图 8-3 ”通过 telnet 成 功 登 录 了 James 的 后 台 
接 下 来 通过 adduser 命 令 为 邮件 系统 添加 用 户 。 如 图 8-4 所 示 ， 添 加 了 用 户 tom， 并 设置 密码 为 000000， 通 过 listusers 命 令 可 以 列 出 当前 的 用 户 列 表 。 


adduser tom 000000 


只 henryyanahny-nmbp ~ telnet localhost 4555 
Trying ::1... 
Connected to Localhost. 


Escape character LS “| . 

JAMES Remote Administration Tool 2.3.2 
Please enter your login and password 
Login id: 

root 


Password: 

Welcome root. HELP for a list of commands 
adduser tom DO000C 

User tom added 

listusers 

Existing accounts 1 

USer: tonm 


图 8-4 添加 邮件 系统 用 户 tom 


接 下 来 利用 邮件 客户 端 验 证 邮件 功能 是 否 正常 ， 图 8-5、 图 8-6、 图 8-7 和 图 8-8 分 别 展 示 了 利用 邮件 客户 端 添加 tom@localhost 账 号 的 步骤 。 


Add Account 


You ll be guided through the steps to set up an 
additional account. 


To get started, provide the following information: 


Full Name: |Tom Wang 


Email Address: to mlocalhost 


Password: ooo 


图 8-5 添加 邮件 账号 


Incoming Mall Server 


Account Type: | @ POP 


Description: | (optional) 


Incoming Mail Server 1Iocolhnost 


User Name: | 


Password: 


图 8-6 设置 POP 协 议 


Outgoing Mail Server 


Description: | (optional) 


Outgoing Mail Server: localhost 
Ed Use only this server 


图 8-7 设置 SMTP 服 务 器 


Account Summary 


Account Description: tom@localhost 
Full Name: Tom Wang 
Email Address: tom®@localhost 
User Name: tom 


Incoming Mail Server: localhost 
加 SSL: off 
hy 
二 Outgoing Mail Server: localhost 


图 8-8 ”邮件 账号 信息 汇总 


给 自己 发 送 一 封 邮件 来 验证 是 否 可 以 正常 的 发 送 (如 图 8-9 所 示 ) 与 接收 邮件 (如 图 8-10 所 示 ) 。 


:| Tom Wang <tom@localhost> 


设置 使 用 ames 发 送 的 邮件 ! 


图 8-9 ”发 送 邮 件 给 tom(@localhost 


MAILBOXES Sort by Date v 
TY 态 Inbox Tom Wang 12:52 AM 
@ 你 好 ， 我 是 Tom 


iCloud 设置 使 用 james 发 送 的 邮件 ! 
局 Localhost DD 


图 8-10 接收 到 新 邮件 


8.1.2 ”通过 Activiti 的 邮件 任务 发 送 邮件 


回归 正题 ， 邮 件 系统 搭建 好 了 ， 如 何在 流程 中 通过 Activiti 的 邮件 任务 自动 发 送 邮件 呢 ? 在 4.3.6 节 中 详细 介绍 了 和 邮件 有 关 的 配置 项 ， 下 面 通过 只 包含 一 个 邮件 任务 的 流程 (如 图 8-11 所 示 ) 来 了 解 自动 
发 送 邮 件 的 配置 ， 对 应 的 代码 如 代码 清单 8-1 所 示 。 


Mall Task 


图 8-11 只 包含 一 个 邮件 任务 的 流程 


代码 清单 8-1 图 8-11 对 应 的 XML 


<process id="testMailTask" name="My process" isExecutable="true"> 
<startEvent id="starteventl" name="Start"></startEvent> 
<serviceTask id="mailtaskl" name="Mail Task" activiti:type="mail"> 


<extensionElements> 
<activiti:field name="to"> // 邮件 接收 方 地 址 
<activiti:expression>${to}</activiti:expression> 
</activiti:field> 
<activiti:field name="from"> // 邮件 发 送 方 地 址 
<activiti:expression>${from}</activiti:expression> 
</activiti:field> 
<activiti:field name="subject"> 
<activiti:expression> 你 好 ，S$ {name}</activiti:expression> 
</activiti:field> 
<activiti:field name="charset"> 
<activiti:string>UTF-8</activiti:string> 
</activiti:field> 
<activiti:field name="html"> 
<activiti:expression> 
<![CDATA[ // 邮件 内 容 


<html> 
<body> 
你 好 $s{name},<br/><br/> 
如 果 你 收 到 这 封 邮 件 ， 恭 喜 你 已 经 学 会 了 如 何 通过 Activiti 的 邮件 任务 发 送 邮件 ! 
</body> 
</html> 
]] > 


</activiti:expression> 


</activiti:field> 
</extensionElements> 
</serviceTask> 
<sequenceFlow id="flowl" sourceRef="starteventl" targetRef="mailtaskl"></sequenceFlow> 
<endEvent id="endeventl1l" name="End"></endEvent> 
<sequenceFlow id="flow2" sourceRef="mailtaskl" targetRef="endevent1l"></sequenceFlow> 
</process> 


对 应 地 ， 通 过 一 个 简单 的 单元 测试 启动 流程 从 而 触发 邮件 任务 的 执行 (该 流程 只 有 一 个 任务 ) ， 单 元 测试 代码 见 代 码 清单 8-2。 


代码 清单 8-2 ”测试 邮件 任务 一 一 James 作 为 邮件 服务 器 


public class MailTaskTest { // 未 继承 AbstractTest 


QRule // 使 用 一 个 单独 的 activiti-mail.cfg.xml 作 为 引擎 配置 

public ActivitiRule activitiRule = new ActivitiRule ("activiti-mail.cfg.xml"); 
@Test 

QDeployment (resources = { "diagrams/chapter8/testMailTask.bpmn" }) 

public void sendMailLocalTest() throws Exception { 

Map<String, Object> variables = new HashMap<String, Object>(); 


variables.put ("name"，"Tom Wang"); // 用 来 蔡 换 邮件 中 的 $ {name]} 
variables.put ("to", "tom@localhost"); 
variables.put ("from", "noreply@localhost"); 


ProcessInstance ProcessInstance = activitiRule.getRuntimeService () 
.StartProcessInstanceByKey ("testMailTask", variables); 
assertNotNull (processInstance); 


} 


在 代码 清单 8-2 中 使 用 activiti-mail.cfg.xml 文 件 创建 了 一 个 ActivitiRule 的 对 象 ， 在 此 文件 中 配置 了 邮件 服务 的 参数 ， 见 代码 清单 8-3 所 示 。 


代码 清单 8-3 ”引擎 配置 文件 activiti-mail.cfg.xml 


<bean id="processEngineConfiguration" class="org.activiti.engine.impl.cfg.StandaloneInMemProcessEngineConfiguration"> 
<property name="databaseSchemaUpdate" value="true"/> 
<property name="mailServerPort" value="2025"/> 


</bean> 


代码 清单 8-3 覆 盖 了 参数 mailserverPort 的 默认 值 (默认 为 25) ， 使 之 和 搭建 的 James 参 数 保持 一 致 。 


在 运行 了 代码 清单 8-2 的 单元 测试 之 后 ， 刷 新 邮件 客户 端的 列表 就 可 以 看 到 如 图 8-12 所 示 的 新 邮件 。 


noreply@lIocalhost a.n00 PM noreply®@localhost 


To tom 二 localhost 
外 好，Tom Wan 一 
rd ds, A 你 好 ，Tom Wang 


性 好 Tom Wang, 闻 采 你 出 


Pa 局 


Tom Wang 12:52 AM 
你 好 ， 我 是 Tom 你 好 Tom Wang, 


设置 使 用 james 发 送 的 邮件 z oe 
如 委 你 收 到 这 封 邮 件 ， 蕉 喜 你 已 经 学 会 了 如 何 通过 Activiti 的 邮件 任务 发 送 邮 件 ! 


图 8-12 ”运行 代码 清单 8-2 之 后 收 到 的 新 邮件 


8.1.3 ”使 用 Gmail 友 送 邮 和 件 


Gmail 的 SMTP 使 用 SSL 加 密 协议 ， 这 和 大 多 数 企业 邮箱 一 样 ， 为 了 安全 起 见 把 邮件 内 容 加 密 。 不 过 在 通过 Activiti 发 送 邮件 时 需要 配置 引擎 的 mailServerUseSSL 属 性 为 “true”。 
代码 清单 8-4 列 出 了 使 用 Gmail 作为 邮件 服务 器 的 配置 。 


代码 清单 8-4 在 引擎 配置 中 设置 Gmail 的 参数 


<bean id="processEngineConfiguration" class="org.activiti.engine.impl.cfg.StandaloneInMemProcessEngineConfiguration"> 
<property name="databaseSchemaUpdate" value="true"/> 
<property name="mailServerHost" value="smtp.gmail.com" /> 
<property name="mailServerUseSSL" value="true" /> // 启用 加 密 
<property name="mailServerPort" value="465" /> 
<property name="mailServerUsername" value="yanhonglei@gmail.com" /> 
<property name="mailServerPassword" value="password" /> 
</bean> 


代码 清单 8-4 窗 盖 了 邮件 配置 的 默认 参数 ， 并 上 且 启用 SSL。 读 者 可 以 把 mailServerUsername 和 和 mailServerPassword 参 数 更 改 为 自己 的 Gmail 账 号 运行 MailTaskByGmailTest ( 见 代 码 清单 8-5) 。 运 行 
之 后 即 可 收 到 邮件 ， 如 图 8-13 所 示 。 


代码 清单 8-5 ”使 用 Gmail 作为 邮件 服务 器 


public class MailTaskByGmailTest { 


@Rule 

public ActivitiRule activitiRule = new ActivitiRule ("activiti-gmail.cfg.xml"); 
@Test 

QDeployment (resources = { "diagrams/chapter8/testMailTask.bpmn" }) 

public void sendMailLocalTest() throws Exception { 


Map<String, Object> variables = new HashMap<String, Object>(); 


variables.put ("name", "Tom Wang"); 
variables.put ("to", "yanhonglei@gmail.com"); 
variables.put ("from", "yanhongleiQgmail.com"); 


ProcessInstance ProcessInstance = activitiRule.getRuntimeService () 
.StartProcessInstanceByKey ("testMailTask", variables); 
assertNotNull (processInstance); 


-7 Yanhonglel@gmall.com to me 


From: vanhongleiDgmail.com <yanhonglei@gmail.com> 
To: vyanhonglel@gmail.com <yanhonglei@gmall.com> 
Date: Monday, December 31 2012 3:48:52 PM 
Subject: 你 好 ，Tom Wang 


学 会 了 如 何 通过 Activii 的 邮件 任务 发 


图 8-13 ” 收 到 了 通过 Gmail 发 送 的 邮件 


8.2 与 业务 集成 


8.2.1 ”即时 发 送 邮 件 


在 第 6 章 和 7.5 节 中 分 别 使 用 三 种 表单 方式 实现 了 请 假 流 程 的 办 理 ， 本 节 将 在 6.1 节 流程 定义 的 基础 上 继续 扩充 ， 为 流程 添加 发 送 邮件 功能 ， 这 样 可 以 在 审批 通过 之 后 发 送 通知 邮件 。 


添加 了 邮件 任务 的 流程 图 如 图 8-14 所 示 。 


图 8-14 请假 流程 一 一 在 审批 通过 之 后 发 送 通知 邮件 


由 于 6.1 节 中 已 经 详细 讲解 了 该 请 假 流程 的 XML 定义 的 含义 ， 因 此 代码 清单 8-6 只 列 出 了 新 添加 的 邮件 任务 “审批 通过 通知 申请 人 ”的 XML 代码 。 


代码 清单 8-6 ”邮件 任务 XML 配置 


<serviceTask id="sendMailForApproved"” name=" 审 批 通过 通知 申请 人 " activiti:type="mail"> 
<extensionElements> 
<activiti:field name="to"> 
<activiti:expression>$ {to}</activiti:expression> 
</activiti:field> 
<activiti:field name="from"> 
<activiti:string>noreply@localhost</activiti:string> 
</activiti:field> 
<activiti:field name="subject"> 
<activiti:string> 请 假 申请 已 审批 通过 </activiti:string> 
</activiti:field> 
<activiti:field name="charset"> 
<activiti:string>UTF-8</activiti:string> 
</activiti:field> 
<activiti:field name="html"> 
<activiti:expression><! [CDATA[ 


<html> 

<body> 
你 好 Ss {name},<br/><br/> // ${name} 用 于 获取 申请 人 的 姓名 
<p> 您 申请 的 请 假 已 经 审批 通过 。</p> 
<hir/> 
<div> 开 始 时 间 : ${startDate}</div> // 请 假 的 信息 取 自 表单 属性 
<div> 结 束 时 间 : ${endDate}</div> 


<div> 请 假 原因 : ${reason}</div> 
</body> 
</html> 
1]]1> 
</activiti:expression> 
</activiti:field> 
<activiti:executionListener event="start" class="me.kafeitu.activiti.chapter8.SetMailInfo"/> 
</extensionElements> 
</serviceTask> 


其 中 ， 在 邮件 任务 被 引擎 创建 时 添加 了 监听 “start” 事 件 的 监听 器 ， 该 监听 器 可 以 在 执行 任务 之 前 将 发 送 邮件 的 一 些 信息 设置 到 变量 中 ， 以 便 从 变量 中 获取 邮件 主题 信息 。 代 码 清单 8-7 列 出 了 start 监 
听 器 的 代码 。 


代码 清单 8-7 ”邮件 任务 Start 监 听 器 一 一 设置 友 送 邮件 时 的 一 些 变量 


public class SetMailInfo implements ExecutionListener 1{ 
public void notify(DelegateExecution execution) throws Exception { 

// 从 Activiti 5.11 版 本 开始 可 以 通过 DelegateExecution 对 象 获取 引擎 的 7 个 Service 对 象 实例 
IdentityService identityService = execution.getEngineServices() .getIadentityService () ， 
String applyUserId = (String) execution.getVariable ("applyUserIg"); // 获取 申请 人 ID 
User user = identityService.createUserQuery() .userId(applyUserId) .singleResult () ; 
execution.setVariableLocal ("to", user.getEmail()); // 申请 人 email 
execution.setVariableLocal ("name", user.getFirstName() + " " + user.getLastName () ) ， 


最 后 将 leave-mail.bpmn 和 leave-mail.png 打 包 成 Zip 文 件 后 部 署 ， 先 用 账号 tom 登 录 申 请 ， 然 后 分 别 用 kermit 和 jeeny 完 成 “部 门 领导 审批 ”和 “人 事 审批 ”任务 办 理 ， 当 “人 事 审批 ”任务 完成 时 刷 
新 邮件 列表 即 可 收 到 一 封 新 邮件 ， 如 图 8-15 所 示 。 


ep : 7-ad ph noreply@localhost 
Ds hes To: tom®@localhost 
你 好 Tom Wang, 您 申请 的 请 假 已 经 审 请 假 昌 请 已 审批 通过 
批 通过 。 开始 时 间 : Tue Jan 08 00... 


noreply@localhost 337 PM 
你 好 ，Tom Wang 你 好 Tom Wang, 


你 好 Tom Wang, 如 果 你 收 到 这 封 ED 

邮件 ， 关 喜 你 已 经 学 会 了 如 何 通 .… 

Tom Wang 12:52 AM 

你 好 ， 我 是 Tom | 开始 时 间 : Tue Jan 08 000000 CST 2013 

设置 使 用 ameas 发 送 的 邮件 ! 结束 时 间 : Thu Jan 10 0070000CST2013 
请 假 原 国 : 公休 


您 申请 的 请 假 已 经 审批 通过 ， 


图 8-15 ”通过 Activiti 的 邮件 任务 发 送 的 邮件 一 一 请 假 申 请 已 审批 通过 


8.2.2 ”定时 发 送 邮 件 


除了 8.2.1 的 即时 发 送 邮 件 ， 在 日 常 的 应 用 中 还 有 另外 一 个 需求 一 一 定时 发 送 邮 件 ， 原 因 有 多 种 ， 例 如 考虑 服务 器 压力 (晚上 批量 处 理 邮 件 队列 ) 、 过 期 提醒 等 。 


假设 现在 要 为 请 假 流 程 添加 一 个 功能 ， 如 果 用 户 在 申请 的 假期 结束 后 1 天 之 内 没有 “销假 ”， 则 发 送 通知 邮件 。 这 个 功能 就 要 利用 4.6.1 小 节 介绍 的 定时 器 边界 事件 来 完成 ， 在 “销假 ”节点 添加 一 个 定 
时 器 边界 事件 ， 以 “请 假 结束 时 间 ” 为 基数 加 上 一 天 作为 定时 发 送 邮件 的 时 间 ， 在 触发 了 定时 器 边界 事件 之 后 执行 输出 流 ， 也 就 是 邮件 任务 。 图 8-16 展 示 了 添加 了 定时 发 送 邮件 的 请 假 流 程 。 


销假 超时 
提醒 


图 8-16 添加 了 定时 发 送 邮 件 的 请 假 流程 
er 图 8-16 的 流程 定义 文件 路 径 为 chapter8/leave-mail-timeout.bpmn。 


如 果 流 程 中 有 定时 任务 需要 开启 引擎 的 Job 功 能 ， 配 置 如 下 : 


<property name="“jobExecutorActivate”’value=“true’”/> 


代码 清单 8-8 列 出 了 图 8-16 中 添加 的 定时 器 边界 事件 及 其 输出 流 “ 销 假 超时 提醒 ”的 XML 代码 片段 。 


代码 清单 8-8 图 8-16 中 添加 的 边界 事件 及 销假 超时 提醒 邮件 任务 的 XML 代码 


<boundaryEvent id="boundarytimerl" name="Timer" attachedToRef="reportBack" 
cancelActivity="true"> #1 
<timerEventDefinition> // ${reportBackTimeout} 表 达 式 用 来 获取 发 送 邮 件 的 任务 
<timeDate>$ {reportBackTimeout}</timeDate> 
</timerEventDefinition> 
</boundaryEvent> 
<serviceTask id="reportBackTimeoutMail" name=" 销 假 超时 提醒 " activiti:type="mail"> 


<extensionElements> 
<activiti:field name=" 
ee expression> 
</activiti:field> 
<activiti:field name="from 
ee ee string> 
</activiti:field> 
<activiti:field name="subje > 
<activiti:string> 销 假 提 醒 </activiti:string> 
</activiti:field> 
<activiti:field name="charset"> 
<activiti:string>UTF-8</activiti:string> 
</activiti:field> 
<activiti:field name="html"> 
<activi ti:expression>&lt; hi tml&gt; 


i pr 


It;body&gt; ”// &1lt; 表 示 < 符 号 ， gt; 表示 > 符号 ，Activiti Designer 自 动 做 了 字符 转 义 
好 S${name},&lt;br/&gt;&1t;br/go 
i a ;您 有 一 个 请 假 申请 需要 销假， 请 及 时 处 理 。 &lt; /pggt; 
lt;hr/&gt; 

;divsot; 开 始 时 间 ， $s{startDate}&lt;/divggt; 
1t;div&gt; 结 束 时 间 : ${endDate}&lt;/div&gt; 
]t;divg&gt; 请 假 原 因 : ${reason}&lt;/div&ggt; 


—、 
已 全 名 名 名 这 名 


el 
| 


lt;/body&gt; 
&lt;/html&gt;</activiti:expression> 
</activiti:field> 
</extensionElements> 
</serviceTask> 
<sequenceFlow idq="flow14" name=" 超 过 1 天 未 销假 发 送 邮 件 通 知 " sourceRef="boundarytimerl" targetRef="reportBackTimeoutMail"></sequenceFlow> 


代码 清单 8-8 和 代码 清单 8-6 的 配置 大 致 一 样 ，#1 处 需要 着 重 说 明 的 就 是 定时 器 边界 事件 的 cancelActivity 属 性 ， 该 属性 值 可 以 设置 为 true 或 false。 
假设 当前 请 假 的 结束 时 间 为 2013-01-01， 那 么 定时 发 送 提醒 邮件 的 日 期 应 该 为 2013-01-02， 这 种 假设 有 下 面 两 种 情况 。 

. 设置 为 true 时 : 如 果 用 户 在 2013-01-02 日 之 前 办 理 了 “销假 ”任务 ， 则 会 取消 “销假 ”节点 的 定时 器 边界 事件 ， 也 就 是 从 Job 列 表 中 删除 定时 器 边界 事件 。 

. 设置 为 false 时 : 不 管用 户 在 2013-01-02 日 之 前 还 是 之 后 办 理 了 “销假 ”任务 ， 都 会 执行 边界 事件 ， 也 就 是 说 “销假 ”任务 完成 后 不 会 取消 相关 的 Job， 所 以 引擎 会 在 2013-01-0200:00:00 准 时 发 送 邮 件 。 
cancelActivity 的 值 要 根据 业务 的 实际 需求 进行 设置 ， 设 定 为 false 有 可 能 会 导致 任务 已 经 办 理 完了 但 用 户 还 是 会 收 到 邮件 。 


为 了 设置 定时 发 送 邮件 的 时 间 ， 需 要 在 代码 清单 8- 7 的 基础 上 添加 一 段 代 码 ， 根 据 请 假 结束 时 间 + 1 天 计算 得 出 一 个 新 的 时 间 ， 并 将 其 设置 到 变量 reportBackTimeout 中 。 


// 超时 提醒 时 间 设 置 ， 请 假 结束 时 间 +1 天 

Date endDate = (Date) execution.getVariable ("endDate"); 
Calendar ca = Calendar.getIinstance(); 

ca.setTime (endDate); 

ca.adgd (Calendar.DAY OF MONTH, 1); 

execution.setVariableLocal ("reportBackTimeout", ca.getTime ()); 


图 8-17 展 示 了 一 封 销假 提醒 邮件 ， 从 中 可 以 看 出 请 假 的 结束 时 间 为 2013-01-01， 邮 件 是 在 2013-01-0215:19:00 发 送 的 (手动 调整 了 系统 时 间 来 模拟 到 期 以 触发 定时 任务 的 执行 ) 。 


noreply@localhost January 2, 2013 3:19 PM 
To: tom@localhost 


钠 假 提醒 


你 好 Tom Wang, 


您 有 一 个 请 假 申 请 需要 请 假 ， 请 及 时 处 理 。 


开始 时 间 : Tue Jan 0100:00n00 CST 2013 
结束 时 间 : Tue Jan 01 000000 CST 2013 
请 假 原 因 : 是 和 否 为 服务 


图 8-17 销假 提醒 邮件 


8.3 ”本 章 小 结 

本 章 的 内 容 只 有 一 个 一 一 邮件 任务 ， 它 不 是 BPMN 2.0 规 范 中 定义 的 ， 而 是 Activiti 引 上 警 在 ServiceTask 上 扩展 的 一 个 特殊 任务 类 型 ， 但 是 由 于 邮件 在 企业 应 用 中 使 用 比例 非常 大 ， 因 此 为 了 更 好 地 将 邮件 
任务 和 Activiti 结 合 起 来 专门 用 一 个 章 的 篇 幅 进行 讲解 。 

本 章 开 头 先 使 用 James 模 拟 企业 的 邮件 系统 ， 使 用 最 简单 的 方式 触发 引擎 的 邮件 任务 ; 另外 针对 企业 邮箱 加 密 的 情况 也 使 用 Gmail 为 例 做 了 讲解 。 


8.2 节 是 本 章 的 核心 内 容 ， 分 别 讲解 了 即时 发 送 邮 件 和 定时 发 送 邮件 ， 带 领 读者 学 习 了 如 何 使 用 邮件 模板 + 流程 变量 的 方式 配置 邮件 内 容 ， 以 及 动态 获取 邮件 接收 和 等 信息 。 除 了 介绍 邮件 任务 的 基础 使 
用 之 外 ， 还 针对 企业 中 常用 的 定时 邮件 进行 了 演示 ， 定 时 器 边界 事件 自动 触发 邮件 的 发 送 ， 并 对 定时 器 边界 事件 的 cancelActivity 属 性 的 取 值 做 了 详细 的 讲解 ， 以 灵活 应 对 不 同 需求 。 


第 9 草 多 实例 


多 实例 (4.3.12 节 ) 特性 在 企业 应 用 中 被 广泛 应 用 ， 因 为 它 允 许多 个 用 户 协作 完成 一 个 任务 (不 仅仅 是 任务 ， 多 实例 支持 很 多 种 类 型 的 活动 ) ， 或 者 批量 处 理 某 项 任务 等 。 
配置 了 多 实例 特性 的 活动 在 流程 运行 时 依次 (顺序 方式 ) 或 单 次 批量 (并 行 方 式 ) 创建 活动 实例 ， 实 例 的 数量 由 不 同 的 参数 决定 (参考 表 4-10) 。 


会 签 ， 顾 名 思 义 ， 就 是 主办 人 (单位 ) 联合 其 他 有 关 人 员 (部 门 ) 联合 办 理 的 过 程 ， 例 如 主办 单位 下 发 公文 (简称 发 文 ) ， 一 般 需 要 多 个 部 门 共 同 审核 通过 之 后 才 允 许 对 外 发 布 。 再 举 一 个 例子 一 一 员 
工 离职 ， 需 要 各 个 部 门 签字 、 盖 章 确认 后 方 可 离职 ， 这 一 过 程 也 称 为 “会 签 ”。 


本 章 将 详细 介绍 多 实例 的 适用 场景 (会 签 ) ， 以 及 如 何在 Activit 配 置 多 实例 ， 还 介绍 多 实例 的 顺序 执行 与 并 行 执行 方式 的 区 别 。 


9.1 非 用 己任 务 


创建 多 实例 ， 根 据 任务 类 型 的 不 同 有 着 不 同 的 方式 。 非 用 户 任务 (例如 Java Service 任 务 ) 可 以 直接 指定 任务 实例 的 数量 (引擎 内 部 会 循环 创建 任务 实例 ) ， 也 就 是 多 实例 任务 执行 的 次 数 ; 用 户 任务 
(UserTask) 如 果 也 像 非 用 户 任务 一 样 指定 任务 的 数量 就 显得 没有 意义 了 ， 因 为 用 户 任务 没有 任务 的 办 理 人 (9.2 节 会 介绍 用 户 任务 创建 多 实例 的 方法 ) 。 


因此 ， 非 用 户 任务 创建 多 实例 任务 ， 可 以 通过 配置 多 实例 任务 的 nrOflnstances 参 数 来 实现 ， 当 然 该 参数 可 以 配置 为 固定 值 (一 般 不 会 这 么 设置 ) ， 也 可 以 通过 变量 方式 动态 配置 。 


代码 清单 9-1 Java service 任务 多 实例 的 XML 代码 


<serviceTask id="servicetaskl" name="Service Task" 

activiti:expression="${counter + 1}" activiti:resultVariableName="counter"> 
<multiInstanceLoopCharacteristics isSequential="false"> // 多 个 实例 并 行 执行 

<loopCardinality>${loop}</loopCardinality> 
</multiInstanceLoopCharacteristics> 

</serviceTask> 


在 代码 清单 9-1 中 ， 对 一 个 Java Service 任 务 添加 了 多 实例 配置 ， 并 且 通 过 设置 属性 isSequentia| 为 false 决 定 多 个 实例 并 行 执行 ， 通 过 变量 loop 决 定 实例 的 数量 ; 每 次 执行 完 一 个 实例 ， 计 数 器 加 1 再 写 
回 到 counter 中 。 针 对 此 例 的 测试 用 例如 代码 清单 9-2 所 示 。 


代码 清单 9-2 ”代码 清单 9-1 的 测试 用 例 


@Test 
QDeployment (resources = { "diagrams/chapter9/testMultiInstanceFixedNumbers .bpmn" }) 
public void testParallel() throws Exception { 
Map<String, Object> variables = new HashMap<String, Object> () ， 
long loop = 3; // 共 创 建 3 个 实例 
variables.put ("loop", loop); 
variables.put ("counter"，0); // 计数 器 从 0 开始 
ProcessInstance ProcessInstance = runtimeService.startProcessInstanceByKey ("testMultiInstanceFixedNumbers", variables); 
Object variable = runtimeService.getVariable (processInstance.getId(), "counter"); 
assertEquals (loop，variable); // 计数 器 的 值 与 oop 变 量 相等 ， 说 明 执 行 了 3 次 


代码 清单 9-2 对 Java service 任务 执行 了 三 次 验证 ， 由 于 Java service 任务 是 自动 执行 的 ， 因 此 当 流 程 启动 之 后 三 个 实例 并 行 执行 (相当 于 开启 了 三 个 子 线程 ) ， 最 后 变量 counter 的 值 与 loop 值 相等 。 


将 本 例 中 Java service 任务 的 多 实例 属性 jssequential 设 置 为 true 或 者 false， 其 结果 总 是 一 致 。 这 是 因为 Java Service 任 务 在 创建 之 后 立即 执行 了 任务 完成 动作 ， 当 设置 顺序 执行 (isSequential 设 置 为 
true) 时 ， 执行 的 过 程 是 一 个 接 一 个 地 执行 ， 所 以 结果 counter 的 值 还 是 3。 


对 于 4.3.12 节 列 出 的 几 个 针对 多 实例 的 内 置 变 量 ， 可 以 将 其 直接 应 用 于 表达 式 中 ， 当 然 也 可 以 在 任务 监听 类 中 获取 内 置 变量 以 便 协助 处 理 业务 逻辑 。 内 置 变量 有 : nrOflnstances、 


nrOfActivelnstances、nrOfCompletedinstances、loopCounter,。 


@ 可 示 邮件 任务 的 多 实例 和 Java Service 任 务 类 似 ， 如 果 需 要 向 一 批 用 户 发 送 邮 件 ， 那 么 可 以 把 邮件 任务 的 to 属性 通过 表达 式 方式 获取 ， 可 以 根据 当前 执行 的 实例 对 象 获 取 不 同 的 邮件 地 址 列表 ， 然 后 
依次 或 执行 发 送 邮件 的 任务 。 


9.2 用户 任务 多 实例 


和 Java Service 一 样 ， 如 果 用 户 任 务 也 通过 设置 |0oopCardinality 元 素 的 值 来 决定 实例 数量 ， 就 显得 之 无 意义 ， 因 为 缺少 了 用 户 任务 的 主要 特性 一 一 人 ， 所 以 用 户 任务 实例 数量 就 需要 由 参与 的 人 数 决 


对 于 本 章 开头 提 到 的 会 签 ， 一 般 由 主办 人 发 起 ， 从 用 户 组 织 树 中 选择 几 个 参与 人 一 同 办 理 任 务 ， 如 果 用 户 任务 设置 了 按照 并 行 的 方式 处 理 ， 那 么 将 一 次 创建 多 个 (和 选择 的 人 数量 相等 ) 实例 ， 并 按照 
选择 参与 人 的 顺序 依次 把 任务 分 配 (assignee) 给 参与 人 。 如 果 按 照 顺 序 的 方式 执行 任务 ， 首 先 会 创建 一 个 任务 实例 分 配给 第 一 个 参与 人 (假设 序号 从 1 开始 ) ， 只 有 在 第 一 个 参与 人 办 理 完 任务 之 后 才 会 创 
建 第 二 个 任务 实例 、 第 三 个 任务 实例 ……， 并 依次 按照 参与 人 的 顺序 设 定 任务 的 办 理 人 。 


对 于 不 同业 务 的 联合 审批 有 着 不 同 的 处 理 方式 ， 下 面 分 别 介 绍 两 种 联合 审批 在 流程 中 如 何 设 定 及 协作 。 
9.2.1 ”顺序 方式 办 理 


顺序 办 理 也 可 以 称 为 排队 办 理 ， 只 有 一 个 人 办 理 完 后 面 的 人 才 可 以 继续 办 理 。 比 如 使 用 纸 质 方式 申请 请 假 ， 需 要 填写 请 假 条 ， 然 后 拿 着 这 张 假 条 找 领导 、 人 事 或 者 总 经 理 审批 ， 但 是 每 次 只 能 找 一 个 人 
签字 确认 ， 顺 序 方式 在 流程 引擎 中 也 是 如 此 。 


代码 清单 9-3 列 出 了 一 个 包含 顺序 多 实例 用 户 任务 的 流程 定义 。 


代码 清单 9-3 用户 任务 多 实例 一 一 顺序 执行 流程 定义 的 XML 代码 


<process id="testMultiInstanceForUserTask" name="testMultiInstanceForUserTask" isExecutable="true"> 


<startEvent id="starteventl" name="Start"></startEvent> 
<userTask id="usertaskl" name="User Task" activiti:assignee="${user}"> #1 
<multiInstanceLoopCharacteristics isSequential="true"” // 顺序 执行 #2 
activiti:collection="${users}"” // 用 户 集合 ， 直 接 写 作 “users” 也 可 以 #3 
activiti:elementVariable="user" // 遍历 users 变 量 的 单个 对 象 变量 名 称 #4 
></multiInstanceLoopCharacteristics> 
</userTask> 
</process> 


代码 清单 9-3 在 #2 处 设置 多 实例 元 素 的 “isSequential” 属 性 为 true， 表 示 多 个 实例 按照 #3 处 activiti:collection 指 定 的 集合 变量 名 称 的 顺序 执行 每 个 实例 ， 在 遍历 users 集 合 时 把 单个 值 保 存在 #4 处 属 
性 “activitielementVariable” 的 “user” 中， 如 此 便 可 在 #1 处 使 用 该 变量 读 取 并 设置 任务 的 办 理 人 属性 。 代 码 清单 9-4 通 过 测试 代码 验证 了 执行 过 程 。 


代码 清单 9-4 代码 清单 9-3 的 测试 用 例 


GTest 
GDeployment (resources = { "diagrams/chapter9/testMultiInstanceForUserTask.users.sequential.bpmn" }) 


public void testForUserCreateByUsersSequential() throws Exception { 
Map<String Object> variables = new HashMap<String Object>(); 
List<String> users = Arrays.asList ("userl"，"user2",， "user3"); // 设置 会 签 的 3 个 用 户 #1 
variables.put ("users", users); 
runtimeService.startProcessIinstanceByKey ("testMulti] 
for (String userId : users) { // 遍历 3 次 
Task task = taskService.createTaskQuery() .taskAssignee (user] 
taskService.complete (task.getId()); 


tI 


[InstanceForUserTask", variables); 


[d) .singleResult ()} 


代码 清单 9-4 在 流程 启动 时 设置 了 变量 “users”， 在 for 循 环 中 每 次 读 取 一 个 任务 (当前 也 只 有 一 个 任务 ) 并 完成 任务 的 办 理 ， 如 此 人 遍历 完 users 集 合 也 结束 了 流程 。 


图 9-1 清 晰 地 描述 了 这 一 过 程 。 


图 9-1 ”多 实例 顺序 执行 的 过 程 


9.2.2 ”并行 方式 办 理 


相对 于 顺序 办 理 方式 来 说 ， 并 行 方式 办 理 的 效率 要 高 得 多 ， 好 比 多 线程 下 载 工 具 。 图 9-2 清 晰 地 描述 了 这 一 过 程 


王 。 


图 9-2 多 实例 并 行 执行 的 过 程 


代码 清单 9-5 列 出 了 一 个 包含 并 行 多 实例 用 户 任 务 的 流程 定义 。 


代码 清单 9-5 ”用 户 任务 多 实例 一 一 并 行 执行 流程 定义 的 XML 代码 


<process idq="testMulLtiInstanceForUserTaSsk"” name="testMulti] 
<startEvent id="starteventl" name="Start"></startEvent> 
<userTask id="usertaskl" name="User Task" activiti:assignee="${user}"> #1 


[InstanceForUserTask" isExecutable="true"> 


<multiInstanceLoopCharacteristics jisSequential="false" // 并 行 执行 ”#2 
activiti:collection="${users}" // 用 户 集合 ， 直 接 写作 \users7 也 可 以 #3 
activiti:elementVariable="user" // 遍历 users 变 量 的 单个 对 象 变量 名 称 #4 
></multiInstanceLoopCharacteristics> 
</userTask> 
</process> 


代码 清单 9-5 和 代码 清单 9-3 除 了 #2 处 属性 “isSequential” 的 值 不 同 之 外 ， 其 他 都 一 样 ， 区 别 在 于 并 行 方式 在 启动 流程 之 后 会 一 次 产生 3 条 任务 并 分 别 设置 任务 办 理 人 为 user1、user2、user3。 代 码 清 


单 9-6 的 单元 测试 可 以 验证 代码 清单 9-5 的 执行 过 程 。 


代码 清单 9-6 ”代码 清单 9-5 的 测试 用 例 


GTest 

QDeployment (resources = { "diagrams/chapter9/testMultiInstanceForUserTask.users.nosequential.bpmn" }) 
public void testForUserCreateByUsersNoSequential() throws Exception { 
Map<String, Object> variables = new HashMap<String, Object>(); 

List<String> users = Arrays.asList ("userl", "user2", "user3"); 

variables.put ("users", users); 

runtimeService.startProcessInstanceByKey ("testMultiInstanceForUserTask", variables); #1 

for (String userId : users) { // 遍历 验证 每 一 个 用 户 都 有 一 个 任务 

assertEquals (1, taskService.createTaskQuery() .taskAssignee (userId) .count ()); 


} 


验证 的 过 程 主要 在 代码 清单 9-6 的 for 循 环 体 中 ， 每 次 验证 一 个 用 户 有 一 个 待 办 任务 ， 即 表示 在 #1 处 启动 流程 后 系统 已 经 产生 了 3 条 待 办 任务 ， 和 图 9-2 中 的 3 个 用 户 相 吻 合 。 


9.2.3 ”设置 结束 条 件 


站 


只 有 在 把 所 有 3 


擎 创建 的 任务 都 办 理 完成 后 9.2.1 和 9.2.2 介 绍 的 两 种 方式 才 会 继续 执行 后 续 输 出 流 ， 如 果 需 要 根据 不 同 的 比例 提前 结束 会 签 ， 该 如 何 做 呢 ? 
现实 中 有 投票 的 例子 ， 比 如 投票 通过 率 为 60% 即 认为 通过 ， 可 以 提前 结束 投票 。 在 BPMN 2.0 规 范 中 允许 设置 多 实例 的 结束 条 件 ， 当 条 件 表 达 式 值 为 true 时 结束 该 任务 的 执行 。 
代码 清单 9-7 展 示 了 一 个 模拟 投票 的 流程 ， 投 票 比 例 大 于 等 于 60% 即 认为 通过 。 


代码 清单 9-7 设置 了 结束 条 件 的 多 实例 


<process id="testMultiInstanceForUserTask" name="testMultiInstanceForUserTask" isExecutable="true"> 
<startEvent id="starteventl" name="Start"></startEvent> 
<userTask id="usertaskl" name="User Task" activiti:assignee="${user}"> 
<multiInstanceLoopCharacteristics isSequential="true" activiti:collection="$ {users}" 
activiti:elementVariable="user"> 
<completionCondition> // 设置 结束 此 任务 的 条 件 
$ {nrOofCompletedInstances / nrOofInstances >= Fatel} #1 
</completionCondition> 
</multiInstanceLoopCharacteristics> 
</userTask> 
</process> 


相对 于 前 面 的 两 个 例子 ， 代 码 清单 9-7 添 加 了 completionCondition 元 素 用 于 设置 一 个 表达 式 ， 通 过 引擎 内 置 变量 (只 对 多 实例 任务 有 效 ) 的 值 获取 任务 完成 比例 和 预期 的 比率 (rate 变 量 ) 相 比 较 的 结 
如 果 值 为 true， 则 结束 该 任务 的 执行 。 对 应 的 测试 代码 见 代 码 清单 9-8 所 示 。 


代码 清单 9-8 ”代码 清单 9-7 的 测试 用 例 


@Test 
QDeployment (resources = { "diagrams/chapter9/testMultiInstanceForUserTask.users.sequential .with.complete.conditon.bpmn" }) 
public void testForUserCreateByUsersSequentialWithCompleteCondition() throws Exception 1{ 
Map<String, Object> variables = new HashMap<String, Object> () ， 
List<String> users = Arrays.asList ("userl", "user2", "user3"); 
variables.put ("users", users); 
variables.put ("rate"，0.69d); // 设置 60% 的 比率 作为 完成 条 伯 #1 
runtimeService.startProcessIinstanceByKey ("testMultiInstanceForUserTask", variables); 
// 第 1 个 用 户 完成 任务 
Task task = taskService.crea 
taskService.complete (task.ge 
// 第 2 个 用 户 完成 任务 
task = taskService.createTaskQuery() .taskAssignee ("user2") .singleResult 
taskService.complete (task.getId()); #3 
// 此 时 该 任务 已 经 结束 ， 因 为 该 流程 只 有 一 个 任务 ， 所 以 流程 结束 
long count = historyService.createHistoricProcessInstanceQuery() .finished() .count (); #4 
assertEquals (1, count); 


TT 


TaskQuery () .taskAssignee ("userl1l") .singleResult (); 
Id()); #2 


一 


) 7 


从 代码 清单 9-8 中 可 以 看 出 ,任务 “usertask1” 分 配 了 三 个 用 户 ,但 是 只 在 #2 和 #3 处 执行 了 任务 动作 ， 在 #4 处 读 取 已 经 结束 的 流程 结果 为 1， 这 样 的 结果 是 在 #1 处 设置 的 rate 变 量 以 及 代码 清单 9-7 中 


#1 处 的 表达 式 在 每 次 任务 完成 (complete) 时 被 调用 并 计算 所 致 。 


9.3 ”应 用 实例 一 一 请 假 会 签 


Vd 


通过 前 面 几 个 单元 测试 相信 大 家 基本 了 解 了 多 实例 的 配置 与 工作 方式 ， 本 节 将 以 请 假 会 签 为 例 展示 多 实例 在 Web 应 用 中 的 应 用 ， 包 括 如 何在 流程 启动 时 选择 参与 人 (对 于 OA 系统 中 的 发 文 流程 来 说 相 


当 于 主办 人 ) 。 


9.3.1 流程 定义 


本 例 的 流程 定义 是 在 第 6 章 动态 表单 的 基础 上 合并 了 “部 门 领导 ”和 “人 事 审批 ”节点 为 “部 门 /人 事 联合 会 签 ”， 新 的 流程 图 如 图 9-3 所 示 。 对 应 的 请 假 会 签 流程 定义 的 XML 代 码 如 代码 清单 9-9 所 示 。 


[部 门 /人 事 ] 
联合 会 签 


代码 清单 9-9 请假 会 签 流程 定义 的 XML 代码 


<process id="leave-countersign" name=" 请 假 流 程 -会 签 " isExecutable="true"> 


<dqocumentation> 请 假 流 程 演示 -会 签 </documentation> 
<startEvent id="starteventl" name="Start" activiti:initiator="app1yUserId"> 
<extensionElements> 
<activiti:formproperty id="startDate" name=" 请 假 开 始 日 期 " type="date" datePattern="yyyy-MM-dd" required="true"></activiti:formproperty> 
<activiti:formProperty id="endDate" name=" 请 假 结束 日 期 " type="date" datePattern="yyyy-MM-dd" required="true"></activiti:formproperty> 
<activiti:formProperty id="reason" name=" 请 假 原因 " type="string" required="true"/> 
// 审批 参与 人 字段 的 type 为 自 定义 类 型 \users”， 实 现 类 见 代 码 清单 9-10 
<activiti:formProperty idq="users" name=" 审 批 参与 人 " type="users" /> #1 
<activiti:formproperty id="validSscript" type="javascript" default="alert (' 表 单 已经 加 载 完 毕 ') ;"></activiti:formProperty> 
</extensionElements> 
</startEvent> 
<userTask idq="countersign" name=" [部 门 / 人 事 ] 联 合 会 签 " activiti:assigqnee="${user}"> 
<extensionElements> // 通过 多 实例 的 user 变 量 设置 任务 办 理 人 
// 省 略 了 请 假 的 时 间 、 请 假 原因 字段 配置 
<activiti:formproperty id="approved" name=" 审 批 意 见 " type="enum"> 
<activiti:value id="true" name=" 同 意 "></activiti:value>  // 单 次 审批 的 结果 
<activiti:value id="false" name=" 拒 绝 "></activiti:value> // 保存 在 变量 approved 中 
</activiti:formproperty> 
<activiti:taskListener event="complete" // 单个 处 理 人 办 理 完 任务 之 后 
delegateExpression="${leaveCounterSignCompleteListener}" /> 
</extensionElements> 
<multiInstanceLoopCharacteristics jijsSequential="false" // 并 行 执行 多 实例 
activiti:collection="users" activiti:elementVariable="user"/> // 设置 用 户 任务 的 办 理 人 
</userTask> 
<userTask id="reportBack" name=" 销 假 " activiti:assignee="${applyUserId}"> 
<extensionElements> 
// 省 略 了 请 假 的 时 间 、 请 假 原因 、 销 假 时间 字 段 配 置 
</extensionElements> 
</userTask> 
<endEvent id="endeventl1l" name="End"></endEvent> 
<sequenceFlow id="flow2" sourceRef="starteventl" targetRef="countersign"> 
<extensionElements> 
<activiti:executionListener event="take" // 初始 化 变量 approvedCounter 为 0 
expression="$ {execution.setVariable('approvedCounter', 0)}" /> 
</extensionElements> 
</sequenceFlow> 
<sequenceFlow id="flow8"” name=" 销 假 " sourceRef="reportBack" targetRef="endevent1"> 
<extensionElements> 
<activiti:executionListener event="take" 
expression="$ {execution.setVariable('result', 'ok')}" /> 
</extensionElements> 
</sequenceFlow> 
<sequenceFlow id="flow13" name=" 全 部 通过 " sourceRef="exclusivegatewayl" targetRef="reportBack"> 
<conditionExpression xsi:type="tFormalExpression"> // 全 部 同意 申请 ， 即 参与 会 签 的 
<![CDATA[${approvedCounter == users.size()}]]> // 人 数 和 同意 申请 的 数量 相等 ， 


</conditionExpression> // 即 通过 率 为 100% 
</sequenceFlow> 
<exclusiveGateway id="exclusivegatewayl" name="Exclusive Gateway" /> 
<sequenceFlow id="flowl4" sourceRef="countersign" targetRef="exclusivegatewayl" /> 


<userTask id="modifyApply"” name=" 调 整 申请 " activiti:assignee="${applyUserId}"></userTask> 

<sequenceFlow idq="flow15" name=" 部 分 通过 " sourceRef="exclusivegatewayl" targetRef="modifyApply"> 
<conditionExpression xsi:type="tFormalExpression"> // 部 分 通过 (包含 全 部 未 通过 ) 
// 审批 通过 的 计数 器 值 小 于 参与 人 的 数量 

<! [CDATA[$ {approvedCounter < users.size()}]]> 

</conditionExpression> 

</sequenceFlow> 

<exclusiveGateway id="exclusivegateway2" name="Exclusive Gateway" /> 


h mh 


<sequenceFlow id="flowl16" sourceRef="modifyApply" targetRef="exclusivegateway2" /> 
<sequenceFlow igd="flowl7" sourceRef="exclusivegateway2" targetRef="endevent1"> 
<conditionExpression xsi:type="tFormalExpression"> 
<![CDATA[${reApply == 'false'}]]></conditionExpression> 
</sequenceFlow> 
<sequenceFlow id="flow18" name=" 重 新 申请 " sourceRef="exclusivegateway2" targetRef="countersign"> 


<extensionElements> 
<activiti:executionListener event='"take" // 重新 申请 时 把 变量 approvedqCountet 置 为 0 
expression="$ {execution.setVariable('approvedCounter', 0)}" /> 

</extensionElements> 

<conditionExpression xsi:type="tFormalExpression"> 

<! [CDATA[${reApply == 'true'}]]></conditionExpression> 

</sequenceFlow> 
</process> 


代码 清单 9-9 看 起 来 比较 长 ， 读 者 可 以 把 重点 放 在 加 粗 和 有 中 文 注释 的 地 方 ， 这 样 比 较 容 易 理解 。 结 合 图 9-3 和 代码 清单 9-9 可 以 得 出 如 下 描述 文字 : 
. 启动 流程 时 把 计数 器 approvedCounter 设 置 为 0 并 选择 参与 人 。 


. 在 每 个 参与 人 办 理 完 任务 后 由 任务 的 complete 事 件 类 型 的 监听 器 处 理 结果 并 保存 ， 当 同意 时 把 变量 approvedCounter 的 值 加 1。 


. 在 所 有 的 办 理 人 都 处 理 完 成 后 执行 排他 路 由 (id 为 exclusivegateway1) ， 如 果 同 意 计 数 器 (approvedCounter) 和 参与 人 数量 相等 ， 即 表示 全 部 通过 ， 否 则 退回 至 “调整 申请 ”。 
#1 处 的 字段 “审批 参与 人 ”的 类 型 为 “users”， 这 不 是 引擎 支持 的 字段 类 型 ， 而 是 根据 需要 自 定义 的 一 个 表单 字段 类 型 (6.2.4 节 ) 。 代 码 清单 9-10 列 出 了 该 字段 类 型 的 实现 代码 。 


代码 清单 9-10 ”请假 会 签 流程 中 表单 字段 类 型 users 的 实现 


public class UsersFormType extends AbstractFormType { 


QOverride 

public String getName() { return "users"; } 

QOverride 

public Object convertFormValueToModelValue (String propertyValue) { 


String[] split = StringUtils.split (propertyValue, ™,"); 
return Arrays.asList(split); // 把 字符 型 的 值 转换 为 List 集 合 对 象 


} 
QOverride 
public String convertModel] ue or a Ue (et modelValue) { 
return ObjectUtils.toString (modelVvalue); // 爷 半 全 和 9 入 转折 田 年 符 
} 
} 


在 6.2.4 节 中 ， 表 单 自 定义 类 型 需要 向 引擎 注册 才能 使 用 ， 下 面 的 配置 就 是 把 代码 清单 9-10 的 表单 字段 类 添加 到 引擎 的 自 定义 表单 字段 类 型 集合 中 。 


<property name="customFormlypes"> 
<list> 


<bean class="me.kafeitu.activiti.chapter6 
.form.JavascriptFormType" /> 
<bean class="me.kafeitu.activiti.chapter9 
.form.UsersFormType" /> 


</list> 
</property> 


9.3.2 ”任务 办 理 


由 于 在 Spring 配置 文件 中 配置 了 自动 部 署 ， 因 此 在 服务 启动 完成 之 后 会 在 流程 定义 列表 中 存在 一 条 名 称 为 “请 假 会 签 ”的 流程 定义 记录 (如 图 9-4 所 示 ) ， 自 动 部 署 的 配置 如 下 : 


<property name="deploymentResources"> 
<list> 
<value>classpath*:/chapter8/leave-mail*.zip</value> 
<value>classpath*:/chapter9/leave-countersign.zip</value> 
</list> 

</property> 


版 本 
流程 定义 上 流程 定义 名 称 流程 定义 KEY ”流程 描述 号 XML 资源 名 称 图 片 资源 名 称 操作 


leave- 请 假 流程 -会 签 leave- 请 假 流程 演示 -会 签 1 leave- leave- 苗 删 除 
countersign:1:10 countersign countersign.bpmn | countersign.png 


天 启动 


图 9-4 已 部 署 的 请 假 会 签 流程 


用 账号 “henry” 登 录 ， 然 后 单 击 图 9-4 中 的 “启动 ”按钮 即 打开 局 动 流程 的 界面 ， 在 此 界面 中 需要 填写 任务 表单 ， 如 图 9-5 所 示 。 


流程 一 [请 候 流 种 -会 要 ]， 版 本 号 : 1 


请 己 开 陪 日 期 2013-01=15 


请 慨 箔 束 日 期 : 0 |-=D1=1 昌 


十 恨 品 因 ， 回老家 


审批 扼 与 人 


种 返 回 列 款 je 月 动 流程 


图 9-5 ”启动 请 假 会 签 流程 
图 9-5 中 的 “审批 参与 人 ”字段 显示 为 灰色 ， 表 示 该 字段 只 读 。 在 对 代码 清单 9-9 中 的 流程 定义 进行 解读 时 对 该 字段 进行 过 说 明 ， 这 是 一 个 自 定义 类 型 的 字段 ， 用 来 保存 该 流程 的 参与 人 ， 由 代码 清单 9- 
10 的 实现 类 进行 类 型 转换 。 


为 了 模拟 企业 应 用 中 从 组 织 树 中 选择 人 员 的 功能 特意 设计 了 一 个 功能 (利用 Bootstrap 的 Modal 展 示 ) ， 可 以 动态 地 读 取 系统 中 的 人 员 并 按照 角色 分 组 显示 ， 用 户 可 以 多 选 ， 单 击 对 话 框 的 “确定 ” 按 
钮 后 把 选择 的 用 户 1D 设 置 到 “审批 参与 人 ”输入 框 中 。 单 击 “ 审 批 参与 人 ”输入 框 后 会 弹出 如 图 9-6 的 对 话 框 ， 可 以 按 住 Ctrl 键 多 选 。 


Kerrmit Mlas (Cerrit, 


管理 风 
Henry Tan 【menry ) 


至 垣 
Bill 2heng 【bi 


Jenm'y Luo (Jenny) 


图 9-6 ”从 对 话 框 中 选择 会 签 参 与 人 


从 图 9-6 中 可 以 看 出 ， 选 择 了 两 个 用 户 ， 分 别 是 部 门 经 理 kermit 和 人 事 经 理 jenny， 单 击 “ 确 定 ” 按 钮 后 “审批 参与 人 ”输入 框 的 值 为 “kermit，jenny”， 如 图 9-7 所 示 。 


审批 参与 人 ， kerrmitjenny 


图 9-7 选择 了 审批 参与 人 
在 完成 表单 填写 后 单 击 图 9-5 的 “启动 流程 ”按钮 触发 流程 启动 动作 ， 然 后 分 别 以 Kermit 和 jenny 身 份 登录 系统 可 以 在 “任务 列表 ”模块 看 到 一 个 待 办 任务 。 从 图 9-8 可 以 清楚 地 看 出 两 个 任务 的 “流程 
实例 |D” 相 同 。 
任务 名 称 流程 实例 ID | 流程 定义 ID 任务 创建 时 间 


部 门 /人 事 ] 联 音 会 签 101 leave-countersign:1:10 Tue Jan 15 01:09:53 CST 2013 


任务 名 称 流程 实例 ID 流程 定义 ID 性 务 创建 时 间 办 理 人 


[部 门 / 人 事 ] 联 合 会 签 101 leave-countersign:1:10 Tue Jan 15 01:09:53 CST 2013 kermit 


图 9-8 ”kermit 和 jenny 分 别 有 一 个 联合 会 签 待 办 任务 


接 下 来 分 别 办 理 待 办 任务 ， 在 “审批 意见 ”处 选择 “同意 ”， 表 示 该 申请 全 部 通过 。 这 样 在 kermit 和 jenny 都 办 理 完成 任务 后 流程 流转 至 “销假 ”节点 。 任 务 办 理 表 单 如 图 9-9 所 示 。 


任务 办 理 一 [[ 部 门 /人 事 ] 联 合 会 签 ]， 流 程 是 义 ID: 


[leave-countersign:1:10] 


请 假 开 始 日 期 : 2013-01-15 
请 假 结束 日 期 : 2013-01-18 


请 假 原 因 : 


图 9-9 ”会 签 任务 办 理 表单 


最 后 用 户 “henry” 登 录 ， 在 “任务 列表 ”可 以 看 到 一 条 名 称 为 “销假 ”的 待 办 任务 ， 如 图 9-10 所 示 。 


任务 ID 任务 名 称 ”流程 实例 ID ”流程 定义 ID 任务 创建 时 间 办 理 人 操作 


16 销假 101 leave-countersign:1:10 Tue Jan 15 01:18:19 CST 2013 | henry 星 办 理 | 


9.4 审批 意见 


9.3.2 节 的 执行 过 程 都 是 申请 通过 的 情况 ， 如 果 审 批 不 通过 该 如 何 处 理 呢 ? 肯定 需要 驳回 的 理由 ， 这 样 申 请 人 在 收 到 被 驳回 的 请 求 时 可 以 清楚 地 知道 为 什么 申请 被 驳回 了 。 


审批 意见 是 工作 流 引擎 中 一 个 不 可 缺少 的 模块 。 流 程 变量 可 以 保存 流程 处 理 过程 中 的 中 间 状 态 (一 般 用 于 条 件 判断 ) ， 审 批 意见 可 以 保存 每 个 任务 (一 般 指 用 户 任务 ) 办 理 时 产生 的 意见 。 例 如 请 假 不 
予 批准 时 领导 通过 填写 审批 意见 ， 在 “调整 申请 ”节点 读 取 并 展示 给 申请 人 。 


本 节 内 容 将 围绕 审批 意见 进行 介绍 ， 利 用 请 假 流程 的 审批 讲解 如 何 使 用 Activiti 的 审批 意见 (Activiti 称 之 为 Comment， 也 可 以 称 之 为 批注 ) 功能 。 
Activiti 在 TaskService 接 口中 定义 了 3 个 和 意见 有 关 的 方法 : 

: addComment(Stting taskId，Stting processInstanceld, String message) 

* getProcesslnstanceComments(String processlnstanceld) 


* getTaskAttachments(String task1d) 


第 一 个 方法 用 于 创建 意见 ， 第 二 个 和 第 三 个 方法 分 别 根据 流程 实例 ID 和 任务 1D 读 取 相 关 意 见 。 从 这 3 个 方法 可 以 看 出 意见 总 是 和 任务 有 关 ， 而 人 可 以 参与 的 任务 只 有 用 户 任务 ， 所 以 意见 依附 于 用 户 任 
7 


图 9-11 在 原来 的 任务 办 理 界面 添加 了 保存 意见 、 读 取 意 见 列表 的 功能 。 
和 王 务 办 理 一 [[ 部 门 / 人 人事] 联合 会 签 ]， 流 程 定义 ID:; [leave-countersign:1:10] 


请 假 开 始 目 期 : 总 Di 号 -中 - 人 与 
请 假 税 束 目 捧 : 2013-D01-18 
请 慨 原 固 : 回老家 
审批 意见 :| 同意 
制 返 回 列 志 


添加 意见 意见 列表 


不 同志 ， 蛋 导 因 走 中. 不 同意 ，18 号 三 走 kermit (名 人事 | 于 全 全 和 1 se013, 1130:56 PM 


中 保存 意见 更 | 城 =——= 调用 taskService.addComment() 


图 9-11 添加 了 保存 意见 和 读 取 意 见 功 能 的 任务 办 理 界 面 
代码 清单 9-11 中 的 两 个 方法 分 别 用 于 保存 意见 和 读 取 意 见 ， 并 且 从 用 户 体验 角度 考虑 使 用 Ajax 方式 发 送 请 求 。 


代码 清单 9-11 保存 意见 的 Controller 方 法 


@QController 
@RequestMapping (Value = "/chapter9/comment") 
public class CommentController { 
// 保存 意见 
QRequestMapping (value = "save", method = RequestMethod.POST) 
@ResponseBody // 保存 后 返回 true， 为 Ajax 请 求 服务 
public Boolean addComment (GRequestParam("task1d") String taskId， 
QRequestParam("processIinstanceld") String ProcessInstanceId， 
QRequestParam("message") String message, HttpSession session) { 
// 设置 当前 人 ， 引 擎 会 把 当前 人 作为 意见 的 所 属 人 
idqentityService.setAuthenticateaqUserId(UserUtil.getUserEromSession (session). getId()); 
// 调用 保存 意见 的 方法 
taskService.addComment (taskId, processInstancelId, message); 
return true; 


} 


QRequestMapping (value = "list/{processInstanceId}") 
QResponseBody 
public Map<String, Object> list (GPathVariable ("processInstanceld") String ProcessInstanceId) { 


Map<String, Object> result = new HashMap<String, Object> () 7 
List<Comment> taskComments = taskService // 根据 流程 实例 ID 读 取 意 见 
.getProcessInstanceComments (processInstancelId); 
List<HistoricTaskIinstance> list = historyService.createHistoricTaskIinstanceQuery () 
.DrocessInstanceId (processiInstanceld) .list (); 
Map<String, String> taskNames = new HashMap<String, String>(); 
for (HistoricTaskInstance historicTaskInstance : list) { 

// 读 取 历史 任务 以 键 值 对 方式 保存 任务 ID 和 名 称 


taskNames .put (historicTaskInstance.getId()，historicTaskInstance .get-Name () ) ， 


} 
result.put ("comments", taskComments); 
result.put ("taskNames", taskNames); 


return result; 
} 
} 


文件 chapter9/src/main/webapp/WEB-INF/view/chapter6/task-form.jsp 包 含 了 对 应 的 Ajax 请 求 的 代码 。 根 据 流程 实例 ID 读 取 意 见 列表 接收 到 的 JSON 格 式 数 据 如 图 9-12 所 示 。 


在 会 签 处 理 完毕 之 后 任务 流转 至 “调整 申请 ”节点 ， 此 时 申请 人 就 可 以 明确 为 什么 申请 被 驶 回 ， 可 以 根据 审批 意见 做 出 处 理 。 图 9-13 展 示 了 调整 申请 节点 的 办 理 页 面 。 


Tcomments: [{id:311, type:comment, userId:kermit, time:1358261958833, taskId:125, 
TO: {id:311, type:comment, userId:kermit, time:1358261958833, taskId:125, proces 
action: "AddComment" 
fullMessage: "不 同 站 ，16 上 号 髓 走 " 
fullMessageBytes: "SLiNSZCMSoSP77yYMMTb LJ7f lho3otbAa" 
id: “311" 
message: "不 同意 ，16 号 再 走 " 
= messageParts: 【不 同意 ，16 号 再 走 ] 
persistentstate: “org.activiti.engine. impl.persistence.entity.CommentEntity” 
"101" 
taskId: "125" 
time: 1458B261950034 
type: "comment™ 
userld: “kermit” 
TtaskNames: {125:[ 部门/ 人事] 联合 会 签 ，129: [部 门 / 人 事 ] 联合 会 签 } 
125: " [部 门 / 人 事 ] 联合 会 签 " 
129: " [部 门 / 人 事 ] 联合 会 签 " 


图 9-12 ” 读 取 意见 列表 接收 到 的 JSON 数 据 


任务 办 理 一 [调整 申请 ]， 流 程 定 义 ID: [leave-countersign:2:510] 


请 假 开始 日 期 : 2013-01-15 
请 假 结束 日 期 | 2013-01-18 
请 个 原因 : “| 回老家 
时 新 申请 ， | 重新 申请 


添加 意见 意见 列表 


1. 情 部 门 既 理 的 意见 办 理 jenny 1/715/2013, 11:38:21 PM 
2. 不 同意 ，16 号 再 走 ”kermit ([ 部 门 / 人 事 ] 瑟 舍 会 签 ) 1715/2013, 11:30:56 PM 


图 9-13 ”调整 申请 任务 办 理 界 面 (有 意见 列表 ) 


9.5 “本章 小 结 


本 章 内 容 以 请 假 会 签 为 例 讲解 了 Activiti 对 多 实例 的 支持 ， 先 介绍 了 顺序 和 并 行 两 种 执行 方式 ， 用 单元 测试 和 实例 阐释 了 两 者 的 不 同 。 对 于 设置 结束 条 件 的 多 实例 任务 可 以 设置 完成 条 件 提前 结束 任务 。 


最 后 介绍 了 审批 意见 在 流程 中 的 应 用 ， 通 过 实例 展示 了 如 何 保存 和 当前 任务 相关 的 意见 ， 以 及 如 何 读 取 意 见 列表 ， 如 此 可 以 清楚 地 知道 参与 人 在 任务 办 理 过 程 中 的 不 同意 见 。 


第 10 草 ” 子 流 程 与 调用 活动 


《 重 构 : 改善 既 有 代码 的 设计 》 一 书 中 提 到 了 LongMethod (过 长 方法 ) 的 重 构 ， 有 编码 经 验 的 程序 员 都 会 下 意识 地 去 重 构 自己 的 代码 ， 让 其 可 维护 性 更 高 、 可 读 性 更 好 。 当 一 个 方法 要 执行 的 任务 过 
于 复杂 时 就 应 该 重 构 代 码 了 ， 如 果 一 个 方法 中 涉及 几 个 功能 的 处 理 ， 此 时 就 应 该 把 每 个 功能 抽取 出 来 单独 处 理 。 举 一 个 例子 ， 一 根 箭 很 容 折 断 ， 一 把 箭 很 难 折断 ， 人 与 人 的 合作 就 像 一 把 箭 ， 而 程序 员 写 代 
码 应 该 是 一 根 箭 ， 这 样 在 遇 到 问题 的 时 候 可 以 清晰 定位 ， 也 便于 其 他 的 阅读 代码 。 


写 代码 和 流程 处 理 有 什么 关系 呢 ? 我 们 再 举 一 个 例子 说 明 它 们 的 关系 : 使 用 Activiti 作 为 工作 流 引 擎 开发 了 一 个 系统 ， 业 务 流程 也 不 算 太 复杂 ， 随 着 时 间 的 推移 客户 的 需求 变 得 越 来 越 复 杂 ， 每 次 用 户 的 
需求 变更 后 流程 设计 也 随 之 变动 ， 如 此 迁 代 ， 时 间 久 了 流程 设计 也 越 来 越 复 杂 ， 久 而 久之 流程 就 很 难 维护 。 


在 代码 中 ， 一 个 方法 的 功能 过 多 时 会 拆 分 为 多 个 方法 ， 对 于 流程 设计 也 是 如 此 ， 可 以 从 业务 层面 抽象 考虑 ， 把 不 同 阶段 的 任务 抽取 出 来 作为 一 个 子 流程 (Subprocess) 处 理 ， 如 此 当 业 务 发 生变 化 时 只 
需要 把 更 改 聚 焦 在 不 同 的 子 流程 上 即 可 ， 主 流程 负责 串联 (输出 流 ) 多 个 子 流程 。 


我 们 在 开发 时 经 常会 使 用 很 多 第 三 方 的 插件 来 完成 特定 功能 ， 例 如 利用 POI 处 理 Excel， 一 般 不 会 自己 去 写 处 理 Excel 的 代码 而 是 利用 现 有 的 通用 组 件 完成 。 在 实际 业务 中 也 经 常会 有 这 样 的 需求 ， 对 于 财 
务工 作 中 的 付款 流程 ， 付 款 的 步骤 基本 固定 ， 有 申请 、 审 批 、 出 纳 付款 等 节点 ， 如 果 一 个 系统 中 有 多 个 地 方 需要 付款 ， 那 就 需要 在 每 个 业务 流程 中 设计 重复 的 付款 流程 (或 者 作为 一 个 子 流程 ) 。 这 样 的 设 
计 有 明显 的 弊端 一 一 重复 上 且 难 以 维护 ， 对 于 有 代码 洁癖 的 人 来 说 是 绝对 不 能 容忍 的 。 


调用 活动 (Call Activity) 正 是 用 来 解决 业务 流程 中 重复 设计 的 问题 的 ， 只 要 设计 好 一 个 通用 (或 共用 ) 的 流程 后 由 其 他 的 流程 引用 即 可 ， 当 通用 的 部 分 变动 时 ， 业 务 流程 无 需 更 改 ， 仪 更 改 通用 流程 即 
可 。 


本 章 内 容 以 采购 办 公用 品 为 例 讲 解 如 何 应 用 子 流程 与 调用 活动 ， 以 及 两 者 的 区 别 |。 


10.1 子 流程 


先 了 解 一 下 整个 办 公用 品 采 购 的 业务 流程 ， 如 图 10-1 所 示 。 和 前 面 章 节 接 触 到 的 流程 相 比 ， 图 10-1 的 流程 图 稍微 “复杂 ”了 一 些 ， 涉 及 子 流程 (4.5.1 节 ) 、 边 界 事件 (4.6.1 节 ) 、 异 常 结束 事件 
(4.1.2 节 ) 。 


调整 后 重新 申请 


捕获 子 流程 


的 呈 关 查 他 | 进入 付费 子 流程 


收 质 确认 


画 从 时 常 结束 事件 
抛 出 同 天 人 入 错误 代码 : 


PAYMENT'IREJEC 王 


图 10-1 ”办 公用 品 采 购 流程 图 


此 流程 的 表单 形式 以 动态 表单 展示 ， 在 启动 流程 时 由 申请 人 填写 申请 内 容 ， 在 领导 审批 通过 之 后 由 后 勤 人 员 和 供 货 方 联系 并 填写 支付 货款 的 账号 信息 ， 随 即 流程 进入 “付费 子 流程 ”， 交 由 财务 部 门 处 
理 ， 财 务 部 门 经 过 审批 后 结束 “付费 子 流程 。”， 之 后 任务 流转 至 “ 收 货 确 认 ” 节 点 (将 任务 分 配给 该 流程 的 申请 人 ) 。 


图 10-1 的 方 框 中 即 是 “付费 子 流程 ”， 在 4.5.1 节 中 做 过 简单 的 介绍 ， 该 子 流程 也 是 一 个 完整 的 流程 ， 有 启动 事件 、 用 户 任务 、 输 出 流 以 及 结束 事件 ， 另 外 还 针对 流程 的 执行 异常 做 了 异常 抛 出 处 理 ， 见 
图 10-1 中 箭头 标记 处 的 说 明 。 在 付费 子 流程 上 还 附加 了 一 个 异常 边界 事件 ， 用 于 捕获 子 流程 抛 出 的 流程 异常 ， 根 据 第 4 章 中 异常 事件 与 异常 边界 事件 的 介绍 可 以 知道 : 抛 出 的 异常 编码 如 果 和 捕获 方 (异常 
边界 事件 ) 定义 的 错误 编码 一 致 ， 则 可 以 捕获 异常 编码 从 而 进一步 处 理 ， 在 此 流程 中 抛 出 与 捕获 的 异常 编码 均 为 “PAYMENT_REJECT”， 所 以 当 捕 获 到 异常 事件 之 后 流程 流转 至 “调整 申请 ”用 户 任务 。 


在 思考 子 流程 中 会 有 针对 金额 (图 10-2 中 的 “总 金额 ”) 的 判断 ， 当 申请 金额 大 于 1 万 元 时 要 经 过 “总 经 理 审 批 ”， 小 于 1 万 元 时 则 不 需要 。 当 然 ， 对 于 排他 分 支 或 者 其 他 需要 使 用 表达 式 的 活动 来 说 ， 
都 需要 以 变量 的 方式 提供 给 流程 实例 才能 计算 得 出 结果 。 在 子 流程 中 判断 金额 是 否 大 于 1 万 的 表达 式 为 “$famountMoney>=10000}”， 其 中 amountMoney 对 应 图 10-2 中 的 “总 金额 ”字段 ， 因 为 子 流 程 实 
例 可 以 读 取 到 主流 程 (也 称 之 为 父 流程 ) 中 的 所 有 变量 ， 所 以 表达 式 “$famountMoney>=10000}” 可 以 正确 计算 得 出 结果 。 


届 采 


2013-02=21 


制 返回 到 表 了 > 启动 流程 


图 10-2 启动 办 公用 品 采 购 流 程 


10.1.1 ”流程 定义 


下 面 分 段 讲解 办 公用 品 采 购 流程 的 XML 定 义 ， 读 者 可 以 打开 本 书 配套 资源 文件 的 本 章 目录 下 的 purchase.bpmn 文 件 查看 完整 的 流程 定义 。 


图 10-2 所 示 的 流程 启动 界面 的 XML 代码 如 下 : 


<startEvent id="starteventl" name="starteventl1" 
activiti:initiator="applyUserId"> 
<extensionElements> 
<activiti:formproperty id="dueDate" name=" 到 货 期 限 " 
type="date" datePattern="yyyy-MM-dd" 
required="true"/> 
<activiti:formProperty id="]isting" name=" 物 品 清单 " 
type="bigtext" required="true"/> 
<activiti:formproperty id="amountMoney"” name=" 总 金额 " 
type="double" required="true"/> 
</extensionElements> 
</startEvent> 


其 中 “物品 清单 ”字段 与 “总 金额 ”字段 的 type 为 自 定义 。 为 了 满足 本 例 的 需求 扩展 了 “bigtext” 和 “double” 两 个 自 定义 表单 字段 类 型 ， 见 代码 清单 10-1 所 示 。 


代码 清单 10-1 ”bigtext 与 double 自 定义 表单 字段 类 型 


// 大 文本 ， 即 html 的 textarea， 继 承 自 引 擎 默认 支持 的 string 类 型 的 实现 
public class BigtextFormType extends StringFormType { 
public String getName () { 
return "bigtext"; 


} 
} 
// java.lang .Double 表 单字 段 类 型 
public class DoubleFormType extends AbstractEFormLIype { 


public String getName () { 
return "double"; 


} 
public Object convertFormValueToModelValue (String propertyValue) { 
return new Double (propertyValue); 


ublic String convertModelValueToFormValue (Object modelValue) { 
return ObjectUtils.toString (modelValue); 


IO ~ 一 


了 


最 后 要 把 自 定 义 的 表单 字段 类 注册 到 引擎 中 ， 下 面 列 出 了 注册 表单 字段 类 的 代码 ， 完 整 的 配置 参见 applicationContext.xml 文 件 。 


<bean id="processEngineConfiguration" class="org.activiti.spring.SpringProcessEngineConfiguration"> 
<property name="customFormlypes"> 
<list> 
<bean class="http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15030/0EBPS/Text/...form.JavascriptFormType" /> 
<bean class="http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15030/0EBPS/Text/...form.UsersFormType" /> 
<bean class="http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15030/0EBPS/Text/... form.DoubleFormType" /> 
<bean class="http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15030/0EBPS/Text/...form.BigtextFormType" /> 
</list> 
</property> 
</bean> 


在 用 户 任务 “联系 供 货 方 ”完成 后 输出 流 指 向 “付费 子 流 程 ”。 从 下 面 的 代码 中 可 以 看 出 “flow22” 的 “targetRef” 属性 为 “subprocessPay”， 并 且 在 这 个 顺序 流 上 添加 了 一 个 监听 器 ， 用 来 设置 变 
量 “usage” 的 值 。 


<sequenceFlow igd="flow22" name=" 进 入 付费 子 流程 " 
sourceRef="contactSupplier" targetRef="subprocessPay"> 
<extensionElements> 
<activiti:executionListener event="take" 
expression="$ {execution.setVariable('usage', listing)}"/> 
</extensionElements> 
</sequenceFlow> 


子 流程 需要 使 用 标签 subProcess 包 衰 ， 其 内 部 的 活动 集合 也 是 一 个 完整 的 流程 。 付 费 子 流程 的 部 分 XML 代 码 如 下 : 


<subProcess id="subprocessPay"” name=" 付 费 子 流程 "> 
<startEvent id="startevent2" name="Start"></startEvent> 
<userTask id="generalManagerAudit" name=" 总 经 理 审批 " 
activiti:candidateGroups="generalManager"> 


// 省 略 表单 字段 


</userTask> 
<conditionExpression xsi:type="tFormalExpression"> 
<![CDATA[$ {amountMoney >= 10000}]]> #1 
</conditionExpression> 
</sequenceFlow> 


<userTask id="pay" name=" 出 纳 付款 " 
activiti:candidateGroups="cashier"> 


// 省 略 表单 字段 


</userTask> 

<endEvent id="errorendeventl1l" name="TerminateEndEvent"> 
<errorEventDefinition errorRef="PAYMENT REJECT"/> #2 

</endEvent> 加 


<sequenceFlow idq="flow18" name=" 金 额 &lt; 1 万 " sourceRef="exclusivegateway2" targetRef="pay"> 
<conditionExpression xsi:type="tFormalExpression"> 


<![CDATA[${amountMoney < 10000}]]> #3 
</conditionExpression> 
</sequenceFlow> 


<userTask id="treasurerAudit" name=" 财 务 审批 " 
tiviti:candidateGroups="treasurer"> 


ac 
// 省 略 表 单字 段 


</userTask> 
<endEvent id="errorendevent2" name="End"> 
<errorEventDefinition errorRef="PAYMENT REJECT" /> #4 
</endEvent> 加 
</subProcess> 


以 上 代码 列 出 了 部 分 关键 代码 ， 省 略 了 表单 字段 部 分 : #1 和 #3 处 利用 主流 程 中 的 变量 amountMoney 作 为 条 件 表 达 式 的 一 部 分 ; #2 和 #4 处 定义 了 一 个 异常 结束 事件 ， 对 应 图 10-1 中 箭头 标记 处 。 


在 主流 程 中 附加 在 付费 子 流程 的 异常 边界 事件 的 定义 如 下 : 


<boundaryEvent id="boundaryerrorl" name="Error" 
attachedToRef="subprocessPay"> 
<errorEventDefinition errorRef="PAYMENT REJECT" /> 
</boundaryEvent> 
<sequenceFlow idq="flow21" name=" 捕 获 子 流程 的 异常 事件 " 
SOUTCeRef='"poundaryerTror1" targetRef="modifyApply" /> 


从 上 面 的 代码 可 以 看 出 : 捕获 到 编码 为 “PAYMENT_REJECT” 的 异常 后 把 输出 流 指向 ID 为 “modifyApply” 的 活动 ， 即 “调整 申请 ”。 
对 于 流程 的 单元 测试 ， 读 者 可 以 参考 本 书 配套 资源 文件 的 本 章 目录 下 的 PurchaseSub-ProcessTest.java 类 。 

10.1.2 ”流程 办 理 
印记 示 启动 本 章 的 示例 后 会 自动 部 署 流程 定义 ， 读 者 可 以 参考 applicationContext.xml 中 属性 “deploymentResoutces” 的 配置 。 


由 于 本 例 的 用 户 任务 涉及 多 个 不 同 的 角色 处 理 ， 为 了 方便 演示 并 接近 真实 需求 添加 了 几 个 角色 和 用 户 ， 如 表 10-1 和 表 10-2 所 示 。 


表 10-1 新 添加 的 角色 


角色 名 称 角 色 ID 


财务 人 员 treasurer 
出 纳 员 cashier 
后 勒 人 员 supportCrew 


表 10-2 ”新 添加 的 用 户 


用 记名 称 用 户 ID 分 配角 色 


Tony Zhang treasurer treasurer, cashier 


Thomas Wang thomas supportCrew 


以 “henry” 用 户 登 录 系统 ， 然 后 启动 一 个 新 的 “办 公用 品 采购 ”流程 实例 ， 如 图 10-2 所 示 。 


更 换 用 户 “kermit” 在 任务 列表 中 显示 一 条 待 办 任务 ， 签 收 并 单 击 “ 办 理 ” 按 钮 后 打开 办 理 页 面 ， 如 图 10-3 所 示 。 


任务 办 理 一 [领导 审批 ]， 流 程 定 久 ID: [purchase-subprocess:1:110] 


申请 人 人 : henry 
到 此 期 限 : 2013-01=27 


物品 浅 单 : 1 ,MacBook Pro 一 
2, 27 寸 县 示 塘 一 音 


是否 同意 :外 同意 


图 10-3 ”领导 审批 表单 


更 换 用 户 “thomas” 在 任务 列表 中 显示 一 条 待 办 任务 ， 签 收 并 单 击 “ 办 理 ” 按 钮 打开 办 理 页 面 ， 如 图 10-4 所 示 。 单 击 “ 完 成 任务 ”之 后 完成 当前 任务 ， 同 时 引擎 自动 启动 一 个 “付费 子 流程 ”的 流程 
实例 ， 从 图 10-5 中 的 数据 库 记 录 可 以 清楚 地 看 出 两 条 流程 实例 由 字段 “PARENT_ID” 维 护 关 系 ，10.1.3 节 会 详细 说 明 。 


共 抽 方 ]， 流 程 下 多 ID: [purchase-subprocess:1:110] 


menry 
2013-01=27 


1. MacBeook Pre— 各 
2.37 寸 显示 器 一 侣 


22300D0 


莫 黑 汉 司 


中 国 工商 银行 


6222972IA47 027402 4 


2013-01=25 


二 和 返回 列表 
图 10-4 用 户 任务 “联系 供 货 方 ” 表 单 


SELECT * FROM ACT_RU_EXECUTION; 


ID |REV_ |PROC INST_ID_ |BUSINESS KEY_ ”|PARENT_ID |PROC DEF ID_ ‘SUPER_EXEC_ |ACT_ID_ IS_ACTIVE_ 
141 |1 114 null |purchase-subprocess:1:110 | null treasurerAudit| TRUE 
114 


1i4 |3 null | |pu rchase-subprocess:1:110 | null | null FALSE 


(2 rows, 2 ms) 


图 10-5 ”启动 了 付费 子 流程 的 数据 库 记 录 


对 于 单个 流程 来 说， 默认 表 “ACT RU EXECU-TION” 的 “ID ”字段 与 “PROC INST ID ”字段 的 值 是 相同 的 ， 如 果 一 个 流程 包含 子 流程 、 调 用 活动 、 多 实例 等 活动 类 型 ， 由 主流 程 触 发 (自动 启 
动 ) 的 Execution 对 象 是 附属 于 主流 程 的 ， 通 过 设置 Execution 记 录 的 “PARENT ID ”字段 的 值 为 主流 程 实例 的 ID 作 为 维护 关系 的 条 件 。 


更 换 用 户 “tony” 在 任务 列表 中 显示 一 条 名 称 为 “财务 审批 ”的 待 办 任务 ， 签 收 并 单 击 “ 办 理 ” 按 钮 打开 办 理 页 面 ， 如 图 10-6 所 示 。 


一 [财务 审批 ]， 流 程 定义 1D: 


2.27 寸 显示 器 一 全 


图 10-6 ”用 户 任 务 “ 财 务 审批 ”表单 


由 于 申请 的 金额 超过 了 1 万 元 ， 因 此 在 tony 办 理 完 任务 “财务 审批 ”之 后 任务 流转 至 “总 经 理 审批 ”， 更 换 用 户 “bill” 后 显示 的 任务 列表 如 图 10-7 所 示 。 


任务 ID 任务 名 称 流程 实例 ID 流程 定义 ID 任务 创建 时 间 办 理 人 | 操作 


151 总 经 理 审 批 114 purchase-subprocess:1:110 Sun Jan 27 18:58:14 GST 2013 blll 量 办 理 


图 10-7 总 经 理 的 待 办 任务 


在 “总 经 理 审批 ”任务 办 理 完成 之 后 骨 次 以 “tony” 身 份 登录 系统 办 理 用 户 任 务 “ 出 纳 付款 ”， 如 图 10-8 所 示 。 在 办 理 完 任务 “出 纳 付款 ”之 后 任务 流转 至 “ 收 货 确 认 ” (自动 设置 任务 的 办 理 人 ) ， 
如 图 10-9 所 示 。 


十 1 月 上 人. henry 


有 用途 : 1. MacBook Pro=— 冶 
2Z, 27 寸 显示 器 一 音 


en, 


慰 琴 访 : 蔓 黑 各 司 


并 月 条 有 中国 前 犁 行 


银行 账号 Bo22g 7 Ue da 


制 吉 回 列 志 


图 10-8 ”用 户 任务 “出 纳 付款 ”表单 


以 上 流程 的 办 理 是 在 假设 所 有 审批 节点 都 通过 的 情况 下 进行 的 ， 读 者 可 以 体验 一 下 “财务 审批 ”或 “总 经 理 审批 ”不 通过 的 情况 (在 是 否 同意 字段 选择 “驳回 ”) : 在 选择 了 “驳回 ”选项 后 完成 任务 
会 执行 异常 结束 事件 ， 捕 获 到 异常 事件 之 后 任务 流转 至 “调整 申请 ”。 


任务 ID 任务 名 称 流程 实例 ID ”流程 定义 1D 任务 创建 时 间 办 理 人 操作 


161 收 货 确认 | 114 purchase-subprocess:1:110 Sun Jan 27 19:04.02 CST 2013 henry 重 办理 


图 10-9 ” 待 办 任务 “ 收 货 确 认 ” 


10.1.3 ”分 析 流 程 数 据 
10.1.1 节 用 XML 的 方式 说 明了 子 流程 如 何 定义 ，10.1.2 节 用 实例 的 方式 展示 了 包含 子 流程 的 流程 的 流转 过 程 ， 本 节 将 从 数据 库 角 度 分 析 ， 解 释 为 什么 子 流程 可 以 获取 主流 程 的 流程 变量 。 


图 10-5 展 示 的 是 运行 时 执行 实例 (Execution) 表 ACT_RU_EXECUTION 的 数据 ， 从 图 中 可 以 看 出 其 流程 实例 |D 均 为 114， 但 是 ID 的 值 不 同 (分 别 为 114，141) 。114 既 是 流程 实例 ID 又 是 一 个 执行 实 
例 ID， 也 可 以 理解 为 第 一 次 启动 流程 时 的 执行 实例 ID 即 为 流程 实例 ID; 但 是 ID 为 141 的 记录 仅仅 是 一 个 执行 实例 ， 当 一 个 流程 有 多 个 执行 实例 时 ， 每 个 执行 实例 
的 “PROC INST ID ”和 “PARENT ID ”字段 的 值 均 为 114， 因 此 就 可 以 把 一 些 了 执行 实例 串联 起 来 。 


全 提示 流程 实例 (ProcessInstance) 与 执行 实例 (Execution) 是 一 对 多 的 关系 。 


我 们 知道 Activiti 引 擎 把 数据 划分 为 运行 (runtime) 和 历史 (history) 两 个 级 别 ， 图 10-5 展 示 的 数据 属于 运行 时 ， 而 在 历史 流程 实例 表 中 的 数据 则 不 同 ， 仅 仅 只 有 一 条 流程 实例 记录 ， 如 图 10-10 所 


[CS BUSINESS_NEY PROC_DEF_ID_ START_TIME_ END_TIME_ DURATION_ START_USER_ID_ 
purchase-subproceas:1 :110|2013-01-27 17:16:35.806|2013-01-27 19:09:14.817|6758011 henry 


图 10-10 ”历史 流程 实例 数据 


在 10.1.1 节 中 ， 子 流程 的 流程 定义 中 包含 了 一 个 排他 分 支 用 于 判断 金额 是 否 超过 1 万 元 ， 而 判断 条 件 是 否 成 立 的 表达 式 使 用 的 是 主流 程 的 表单 字段 “amountMoney”， 我 们 没有 在 任何 地 方 为 子 流程 设 


置 该 变量 的 值 ， 为 什么 子 流程 可 以 使 用 呢 ? 图 10-11 用 实际 的 数据 给 出 了 很 好 的 解释 。 


简单 来 说 ， 子 流程 可 以 “共享 ”主流 程 的 所 有 变量 ， 而 且 子 流程 设置 的 变量 也 以 主流 程 的 执行 实例 ID 作为 依据 ， 所 以 子 流程 在 获取 数据 时 使 用 主流 程 的 执行 实例 ID ( 子 流程 对 应 的 执行 实例 的 
PARENT_ID 字段 值 ) 就 可 以 获取 到 主流 程 的 变量 


SELECT * FROM ACT_HI_VARINST: 


wl 有 ASK_ID_ MAME BYTEARRAY_ID_ DOUBLE_ LONG _ TEXT_ | 
114 mr applyUserld nu muti null henry 


I 4 mW aveDae tm on nm jason6oioo | 


121 |1i4 listing Strim 习 nu 1. MacBook Pro 一 台 
2. 27 十 显示 器 一 台 
122 |114 anmourntMoney gdouble 22300.0 mull 


mie me 
FE CC EC 
om so 


138 |114 bankAccount ny nu PLM 6222972347027340242 
-- 囊 - 弄 二 一 
2.27 寸 量 示 器 一 
197 1114 4 ni treasurerApproved smmg 0 nm nm mm me 
tl la wy omeawenaewpovalam oo wm le | 


10.2 调用 活动 


如 果 说 子 流程 是 一 个 类 中 的 一 个 private 方 法 ， 只 能 被 当前 类 调用 ， 那 么 调用 活动 就 更 上 一 层 ， 把 一 个 通用 的 方法 提取 到 一 个 独立 的 类 中 供 所 有 的 类 使 用 。 


一 般 来 说 每 个 公司 都 有 一 套 完整 的 付款 流程 ， 而 且 适 用 于 不 同 的 业务 ， 所 以 把 付费 流程 设计 为 一 个 独立 上 且 通 用 的 流程 是 很 有 必要 的 。 


10.2.1 流程 定义 


在 了 解 了 子 流程 与 调用 活动 的 区 别 后 我 们 利用 10.1 节 的 例子 把 一 个 流程 分 离 为 两 个 独立 的 流程 ， 以 达到 付费 流程 的 通用 性 目的 。 图 10-12 列 出 了 拆 分 后 的 两 个 独立 流程 定义 的 文件 列表 。 


payment.bpmn 
payment.png 


payment.zip 
purchase-callactivity.bpmn 
purchase-callactivity.png 
purchase-callactivity.zip 


图 10-12 ” 拆 分 流程 后 的 文件 列表 


其 中 payment.bpmn 为 拆 分 后 独立 的 付费 流程 ，purchase-callactivity.bpmn 为 主流 程 。 


图 10-13 展 示 了 办 公用 品 采 购 的 主流 程 (Purchase-callactivity.bpmn) ， 图 10-14 展 示 了 抽取 后 独立 的 付费 流程 (payment.bpmn) 。 


与 子 流程 不 同 的 是 : 调用 活动 是 以 “引用 ”的 方式 把 一 个 流程 作为 主流 程 的 一 个 活动 ， 当 输出 流 到 达 调 用 活动 时 引擎 会 自动 启动 一 个 独立 的 流程 实例 ， 并 把 主流 程 的 执行 实例 作为 上 级 执行 实例 


(Super Execution) 。 


图 10-13 办公 用品 采购 主流 程 


图 10- 14 独立 通 用 的 付费 流程 


本 例 的 业务 流程 和 10.1.1 中 一 致 ， 不 再 做 重复 的 讲解 ， 仅 针对 子 流程 与 调用 活动 的 XML 定义 做 出 比较 。 


<process id="purchase-callactivity" isExecutable="true" 
name=" 办 公用 品 采 购 --callactivity 方 式 "> 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15030/0EBPS/Text/... 
<callActivity igd="callactivity-payment" 
name=" 付 款 " calledElement="payment"> 
<extensionElements> 
<activiti:in source="applyUserId" 
target="applyUserId"/> 
<activiti:in source="listing" target="usage"/> 
<activiti:in source="amountMoney" 
target="amountMoney"/> 
</extensionElements> 
</callActivity> 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15030/0EBPS/Text/... 
</process> 


使 用 callActivity 代 替 了 subProcess， 使 用 属性 calledElement 的 值 定 义 了 外 部 流程 的 流程 ID， 使 用 activitiin 标 签 定义 了 两 个 输入 类 型 的 变量 ， 这 样 独立 的 付款 流程 就 可 以 使 用 target 属 性 值 作为 变量 名 
获取 变量 ， 因 为 调用 活动 不 能 读 取 调 用 方 的 变量 ， 必 须 通过 activiti:in 显 示 的 指定 。 


10.2.2 单元 测试 


对 于 10.1.1 节 的 流程 定义 ， 可 以 运行 PurchaseSubProcessTest.java 单 元 测试 来 模拟 、 验 证 流程 的 运行 过 程 和 结果 ; 对 于 10.2.1 节 中 调用 活动 版 本 的 办 公用 品 采 购 流程 ， 可 以 运行 单元 测试 类 
PurchaseCallActivityTest,java 来 模拟 、 验 证 流程 的 运行 过 程 和 结果 。 


本 节 的 目的 是 要 指出 两 种 测试 的 不 同 。 
1 .流程 部 署 


对 10.1.1 节 中 流程 定义 进行 测试 ， 只 需要 部 署 一 个 流程 定义 文件 即 可 ， 代 码 如 下 : 


@Test 

QDeployment (resources = 1 
"diagrams/chapterl0/purchase-subprocess .bpmn" }) 

public void testAllApproved() throws Exception { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15030/0EBPS/Text/... 


} 


但 是 对 于 10.2.1 节 的 流程 定义 则 不 同 ， 需 要 部 署 两 个 流程 文件 方 可 正常 运行 测试 ， 因 为 在 流程 执行 到 “付款 ”活动 时 需要 调用 外 部 的 流程 (流程 ID 为 “payment”) ， 代 码 如 下 : 


GTest 

QDeployment (resources = 1 
"diagrams/chapterl0/purchase-callactivity.bpmn", 
"diagrams/chapterl0/payment .bpmn" }) 

public void testAllApproved() throws Exception { 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15030/0EBPS/Text/... 


} 


2. 变 量 获 取 


从 子 流程 的 测试 类 中 获取 变量 “usage” 的 代码 如 下 ， 其 中 processlnstance 为 主流 程 的 流程 实例 对 象 。 


Execution subExecution = 
runtimeService.createExecutionQuery () 
.ProcessInstancelId (processInstance.get1d()) 
.activityId("treasurerAudit") .singleResult () ， 

assertNotNull (subExecution); 

assertEquals (listing, runtimeService 

.getVariable (processInstance.get1Id(), "usage")); 


对 于 10.2.1 节 中 的 流程 定义 ， 要 获取 变量 “usage” 这 种 方式 就 行 不 通 了 ， 因 为 两 个 流程 实例 是 独立 的 ， 不 可 以 相互 共享 变量 ， 只 有 子 流程 才 可 以 如 此 。 具 体 的 代码 如 下 : 


Execution subExecution = 
runtimeService.createExecutionQuery () 
.processDefinitionKey ("payment") .singleResult () ， 
assertNotNull (subExecution); 
assertEquals (listing, runtimeService 
.getVariable (subExecution.getId(), "usage")); 


从 上 面 的 代码 可 以 看 出 : 获取 subExecution 对 象 的 方式 是 根据 流程 定义 的 Key 属 性 查询 的 ， 而 在 子 流程 测试 中 是 根据 主流 程 的 执行 实例 ID 获取 的 。 


10.2.3 流程 办 理 


图 10-15 中 有 3 个 流程 定义 对 象 ， 分 别 是 10.1 节 中 包含 子 流程 的 办 公用 品 采购 ， 以 及 本 节 拆 分 后 得 到 的 两 个 独立 流程 定义 : 


payment:1:15 通用 付款 流程 payment paymeant.bpmn payment.png 

purchase- 办 必用 晶 困 网 -= purchase- purchase- purchase- 

callactivity:1:14 callactivity 方 式 callactivity callactivity .bpmmn callactivity.png 

purchase- 1 办 公用 品 采购 Purchase- 1 purchase- purchase- 曾 开 及 | b> 启动 
Subprocess:1:16 Subprocess subprocess.bpmn subprocess.png 


图 10-15 “已 部 署 流程 定义 


因为 两 个 版 本 的 流程 定义 的 流程 一 致 ， 所 以 从 Web 界 面 看 不 出 有 什么 不 同 ， 读 者 可 以 根据 10.1.2 节 的 办 理 步 骤 完 成 拆 分 后 的 办 公用 品 采 购 流 程 。 值 得 提醒 的 是 : 当 用 户 任务 “联系 供 货 方 ”完成 后 注意 
观察 表 “ACT_RU_EXECUTION” 的 数据 ， 流 程 流转 产生 的 数据 将 在 10.2.4 节 中 详细 分 析 。 


另外 一 点 不 同 是 完成 任务 的 Controller 方 法 需要 加 以 改进 ， 如 果 通 过 主流 程 启动 的 外 部 流程 设置 了 activiti:initiator 属 性 ， 则 不 能 获取 到 当前 操作 人 。 对 TaskController 的 completeTask 方 法 进行 改进 的 
代码 如 下 ， 其 中 加 粗 部 分 即 为 改进 之 处 ， 这 样 外 部 流程 就 可 以 获取 到 触发 调用 活动 的 操作 人 变量 。 


GReauestMapping(value = "task/complete/{taskId}") 

public String completeTask 
8 0 0 

ttpServietRequest 工 Exception { 

/7 委 宣 当 前 民 作 人 对 萌生 二 区 甘 取 到 当 训 损人 入 

identityService.setAuthenticatedUserId (UserUtil.getUserEromSession (request.getSession()) .getId()); 

http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15030/0EBPS/Text/... 


一 、 


10.2.4 “分 析 流 程 数 据 


在 子 流程 节 中 已 经 分 析 了 图 10-5 的 数据 记录 ， 本 节 使 用 的 调用 活动 的 版 本 在 运行 时 产生 的 数据 也 与 之 类 似 ， 如 图 10-16 所 示 ， 不同 的 是 比 图 10-5 多 出 了 1 条 记录 ， 这 多 出 来 的 一 条 记录 是 流程 运行 至 “ 付 
“调用 活动 时 产生 的 。 注 意 第 2 条 记录 (ID 字段 的 值 为 48) 的 “SUPER_EXEC_ ”字段 的 值 为 46， 表 明 该 记录 是 由 ID 为 46 的 执行 实例 创建 的 。 


由 


进一步 分 析 执 行 实例 的 状态 : 流程 实例 (ID 为 20) 的 状态 (IS_ACTIVE 字段 ) 为 “ 挂 起 ”， 由 该 流程 实例 (ID 为 20) 创建 的 执行 实例 处 于 “活动 ”状态 ， 独 立 的 付费 流程 实例 也 处 于 “活动 ”状态 。 


SELECT * FROM ACT_RU_EXECUTION 
如 aa KEY_ | -有 SUPER EXEC_ IACT ID_ Po [Is ALTIVE_ 
Pr 1:14 |null callactivity-payment TRUE 


| purchase-callactivity:1:14 | null null IFALSE 


图 10-16 “办 公用 品 采购 的 调用 活动 版 本 在 运行 时 执行 的 实例 数据 记录 


对 应 地 ， 在 整个 流程 实例 执行 结束 之 后 查询 历史 流程 实例 表 可 以 看 到 如 图 10-17 所 示 的 结果 。 从 记录 中 可 以 看 出 ， 办 公用 品 采 购 流程 的 流程 实例 ID 为 120，“ID_ ”为 148 的 记录 是 由 主流 程 在 执行 过 程 中 
创建 的 ， 通 过 字段 “SUPER PROCESS INSTANCE ID ”的 值 可 以 看 出 ，“ID ”为 148 的 记录 的 “SUPER PROCESS INSTANCE ID ” 值 为 120， 以 此 建立 了 上 下 级 关系 。 


LECT * FROM ACT_HI_PROKCINST, l | 
D_ |PROC_INST_ID_ [BUSINESS_KEY_ [PROC_DEF_ID- [TART_TIME- [END_TIME- [DURATION. [START_USER_ID. [START_ACTID. [END_ACT-ID. 


” 国 国 再 本 百 生 下 二 而 国 司 图 国 ” 国 国 二 J 国 “本 | pe 
1dB 1 mu parmant:l:11s 2013D12B 21:51:21.789|2013202 21:30:42.669 430760B30 thomas 


120 |120 mu purc hasetallactisity:l:114|201301-28 21:50:40.32512013-2-02 21:31:05.298|430B24973 henr 


图 10-17 ”流程 结 来 之 后 历史 流程 实例 表 的 数据 记录 


和 子 流程 相 比 较 ， 调 用 活动 除了 会 创建 一 个 独立 并 附属 于 主流 程 的 子 流程 实例 之 外 ， 在 变量 方面 还 有 不 同 之 处 : 在 子 流程 中 设置 的 流程 变量 和 主流 程 的 变量 使 用 相同 的 Execution1d 作 为 保存 依据 (参考 
图 10-11) ， 而 调用 活动 是 一 个 独立 的 流程 实例 ， 所 以 在 调用 活动 中 设置 的 变量 会 和 主 记 录 分 离开 来 。 从 图 10-18 中 可 以 看 出 这 些 变 量 记录 的 “EXECUTION_ID_” 字 段 的 值 有 两 个 ， 而 图 10-11 中 只 有 一 个 
相同 的 “EXECUTION ID ” 。 


i FROM ACT_HI NARINST where PROC_INST_ID_ = 120 or PROC_INST_ID_ =148 order by ID ; 


PROC INST_ID |EXECUTION_ID_ TASK ID |NAME_ VAR_ TYPE |REV_ [BYTEARRAY _ ID_ IDOUBLE_ |LONG_ 
121 120 nu PY Ee null nu ee mi 


ou 1361894400000 


lz27 |120 nuit listing Se 一 nu nu 1. MacBook 户 虽 一 音 | nu 
a. 27 寸 显示 器 一 台 
1l28 |120 120 nu amounthorey double i 肯 R no 22300.0 | noi 


NN 


后 


144 120 120 nu bankiceount me 0 muit nu E22232947927342 nui 
145 /120 120 null planDate 0 nu 1359302400000 nuit Mul 
0 mu 


a i nappyUser 


149 |i148 1 有 8 mu L359e string 0 nu nun 1. MaecBook 户 虽 一 癌 | nu 
4. 27 寸 显示 器 一 癌 
150 /i148 148 nuil amourthorney co uble 0 null 22300.0 | nwt nult 


arr rr re rr re re re 
209 |148 148 nu generalManagerApproved |string 0 mult nu true muni 
量 记录 


在 图 10-18 中 ， 字 段 “EXECUTION ID _” 值 为 148 的 变量 记录 是 由 独立 的 付费 流程 设置 的 ， 字 段 “NAME ” 值 为 applyUserld、usage、amountMoney 的 记录 是 在 启动 付费 流程 时 设置 的 ， 而 启动 时 
的 流程 变量 一 部 分 是 由 主流 程 中 的 “callActivity” 通过 “activiti:in” 决定 的 。 


10.3 ”事件 子 流程 


事件 子 流程 (4.5.3 节 ) 和 子 流程 类 似 ， 把 一 系列 的 活动 归结 到 一 起 处 理 ， 不 同 的 是 事件 子 流程 不 能 直接 启动 ， 而 要 “被 动 ”地 由 其 他 的 事件 触发 启动 。 
在 10.1.1 节 的 办 公用 品 采 购 流程 中 ， 如 果 付 费 子 流程 未 通过 财务 或 总 经 理 审批 ， 则 抛 出 一 个 异常 事件 ， 紧 接着 异常 事件 被 附加 在 付费 子 流程 上 的 异常 边界 事件 捕获 ， 这 是 处 理 流程 异常 的 一 种 方式 .。 


举 个 例子 ， 对 于 未 通过 财务 或 总 经 理 审批 的 付费 子 流程 ， 不 用 边界 异常 事件 捕获 而 是 在 一 个 子 流程 (包含 一 个 事件 启动 流程 ， 可 以 是 异常 启动 事件 、 消 息 启动 事件 ) 中 进行 处 理 。 图 10-19 展 示 了 办 公 
用 品 采购 的 另外 一 个 版 本 ， 和 10.1.1 节 的 例子 的 区 别 体现 在 对 付费 子 流程 中 有 异常 情况 的 处 理 ， 图 中 两 个 箭头 的 来 源 是 两 个 可 能 抛 出 异常 的 “异常 抛 出 事件 ”， 箭 头 所 指 的 是 事件 子 流程 的 “ 噶 常 启动 事 
件 ”， 当 异常 抛 出 事件 的 异常 编码 能 和 流程 的 异常 捕获 事件 (包括 异常 启动 事件 、 中 间 异 常 捕获 事件 ) 设置 的 异常 编码 匹配 就 可 以 被 捕获 。 


如 果 图 10-19 中 的 流程 在 运行 时 未 通过 财务 或 者 总 经 理 审批 ， 则 会 触发 “捕获 付费 子 流程 异常 。 子 流程 的 异常 启动 事件 ， 从 而 启动 一 个 子 流程 处 理 异常 ， 本 例 执行 一 个 Java Service 任 务 记 录 异 常 信息 。 


[3 


联系 供 货 方 


进入 付费 子 流 程 
付费 子 流 程 
| 金额 >=1 万 元 | 


EE 
总 经 理 审 批 


- 抛 出 异常 时 执行 8 捕获 付费 也 流程 怪 宫 > 


图 10-19 ”包含 事件 子 流程 (异常 事件 ) 的 办 公用 品 采购 流程 
10.3.1 流程 定义 
本 节 主 要 展示 和 事件 子 流 程 相 关 的 流程 定义 XML 代码 ， 例 如 当 财 务 或 者 总 经 理 审批 不 通过 时 如 何 处 理 以 及 如 何在 事件 子 流 程 捕获 异常 。 


和 10.1.1 节 的 例子 不 同 ， 我 们 在 “财务 不 同意 ”以 及 “总 经 理 不 同意 ”输出 流 上 添加 了 一 个 执行 监听 器 (下 面 的 代码 中 的 加 粗 部 分 ) 来 设置 异常 信息 (保存 在 一 个 变量 中 ) ， 对 应 的 XML 代码 如 下 : 


<sequenceFlow id="flow-treasurerAudit" name=" 财 务 不 同意 " 
sourceRef="exclusivegateway-treasurerAudit" 
targetRef="errorendevent2"> 
<extensionElements> 
<activiti:executionListener event="take" 
class="me.kafeitu.activiti.chapter10.listeners 
.HandleErrorIinfoForPaymentListener"/> 
</extensionElements> 
<conditionExpression xsi:type="tFormalExpression"> 
<![CDATA[${treasurerApproved == 'false'}]]> 
</conditionExpression> 
</sequenceFlow> 


监听 器 的 功能 比较 简单 ， 设 置 抛 出 流程 异常 的 原因 ， 以 便 事件 子 流程 可 以 根据 原因 进行 分 析 人 处理。 监听 器 的 代码 如 下 : 


public class HandleErrorinfoForPaymentListener 
implements ExecutionListener { 
QOverride 


public void notify(DelegateExecution execution) 
throws Exception { 
String activitylId = execution.getCurrentActivityIqd(); 
if ("exclusivegateway-treasurerAudit".equals (activity1d)) { 
execution.setVariable ("message"，" 财 务 审批 未 通过 ")，; 
} else if ("exclusivegateway-generalManagerAudit".equals (activity1Id)) { 
execution.setVariable ("message"，" 总 经 理 审批 未 通过 ")，; 


} 
} 
} 


从 上 面 的 代码 中 可 以 看 出 : 根据 排他 分 支 的 ID 进行 判断 ， 区 分 审批 未 通过 的 来 源 是 财务 还 是 总 经 理 ， 如 此 子 流程 即 可 获取 名 称 为 “message” 的 变量 值 分 析 并 处 理 噶 常 。 


定义 一 个 事件 子 流程 的 XML 代码 和 普通 的 子 流程 类 似 ， 唯 一 不 同 的 是 事件 子 流程 在 “subProcess”′ 标签 上 多 了 一 个 属性 triggeredByEvent= “true”。 图 10-19 中 的 事件 子 流 程 的 XML 代码 如 下 : 


<subProcess id="catchErrorForPpayment" 
name=" 捕 获 付费 子 流程 异常 " triggeredByEvent="true"> 
<startEvent id="errorstarteventl" name="Error start"> 
<errorEventDefinition errorRef="PAYMENT REJECT"/> 

</startEvent> 
<serviceTask id="recordErrorInfo" name=" 记 录 异 常 信息 " activiti:expression="$ {execution.setVariable ('ERROR INFO', message) }"></serviceTask> 
<endEvent id="endevent6" name="End"></endEvent> 加 

</subProcess> 


在 startEvent 中 添加 元 素 errorEventDefinition 后 就 可 以 表示 这 是 一 个 异常 启动 事件 ， 一 旦 当前 流程 抛 出 了 一 个 异常 且 和 属性 errorRef 的 值 匹 配 ， 则 触发 该 事件 ， 本 例 将 启动 “捕获 付费 子 流程 异常 ” 子 流 


程 。 


10.3.2 单元 测试 


我 们 借助 代码 清单 10-2 中 的 单元 测试 来 模拟 10.3 节 开头 提 到 的 场景 ， 在 付费 子 流程 中 抛 出 一 个 异常 验证 是 否 能 够 触发 事件 子 流程 。 


代码 清单 10-2 ”验证 图 10-19 中 的 事件 子 流程 是 否 执行 


QContextConfiguration("classpath:app1icationContext-test-chapter10 .xml") 
public class PurchasePrrorEventSubProcessTest extends SpringActivitiTestCase { 
@Test 
QDeployment (resources = { "diagrams/chapter1l0/purchase-error-event-subprocess.bpmn" }) 
public void testRejectOnTreasurer() throws Exception { 
Map<String, String> properties = new HashMap<String, String>(); 
.… // 省 略 设置 变量 代码 
identityService.setAuthenticatedUserId ("henryyan"); 
… // 省 略 查 询 流程 定义 代码 
ProcessInstance ProcessInstance = formService.submitStartFormData (processDefinition.getId(), properties); 
assertNotNull (processInstance); 
.. // 部 门 领导 审批 通过 
… // 完成 任务 : 联系 供 货 方 
// 子 流程 -财务 审批 
task = taskService.createTaskQuery() .taskCandidateGroup ("treasurer") .singleResult 1() ， 
taskService.claim(task.getId(), "kermit"); 
properties = new HashMap<String, String>(); 
properties.put ("treasurerApproved"， "false"); // 设置 审批 未 通过 
formService.submitTaskFormData (task.getId(), properties); #1 


// 验证 执行 了 事件 子 流程 

HistoricVariableInstance ERROR INFO = #2-S 
historyService.createHistoricVariableInstanceQuery() .variableName ("ERROR INFO") .singleResult (); 
assertEquals ("财务 审批 未 通过 "，ERROR INFO.getValue () ) ; #2 一 


可 以 在 IDE 中 执行 该 单元 测试 ， 毫 无 疑问 ， 所 有 的 断言 均 通 过 验证 。 


代码 清单 10-2 的 #1 处 是 财务 审批 任务 完成 动作 ， 将 变量 treasurerApproved 设 置 为 fase， 当 任务 完成 后 触发 事件 子 流程 的 异常 启动 事件 ， 紧 接着 执行 了 Java Service 任 务 “ 记 录 异 常 信息 ”， 若 #2 处 从 历史 
变量 中 获取 名 称 为 “ERROR INFO” 的 变量 值 等 于 监听 器 HandleErrorlnfoForPaymentListener.java 设 置 的 变量 message， 则 “财务 审批 未 通过 ” 。 


10.4 ”多 实例 支持 


在 上 一 章 中 详细 讲解 了 多 实例 的 应 用 ， 使 读者 学 会 了 批量 任务 处 理 。 多 实例 支持 的 活动 类 型 有 很 多 ， 本 章 介 绍 的 子 流程 与 调用 活动 可 以 支持 多 实例 特性 。 


在 实际 应 用 中 子 流程 的 多 实例 应 用 也 比较 广泛 ， 例 如 领导 向 下 属 分 发 任务 (注意 这 里 的 任务 不 是 一 个 普通 的 用 户 任务 ， 而 是 一 个 子 流程 或 者 调用 活动 ) ， 并 且 要 求 每 一 个 子 流程 中 的 某 个 任务 自动 分 配 
给 多 实例 的 参与 者 。 图 10-20 展 示 了 任务 分 发 的 流程 图 。 


图 10-20 任务 分 配 流程 图 ( 子 流程 多 实例 ) 


图 10-20 中 的 “员工 子 任务 ” 子 流程 启用 了 多 实例 特性 支持 ， 以 并 行 方式 执行 ， “员工 子 任务 ” 子 流 程 实例 个 数 由 主流 程 的 “领导 分 发 任务 ”设置 的 一 个 集合 “users” 决 定 ， 将 用 户 任务 “员工 处 理 任 
务 ” 的 activitiassignee 属 性 设置 为 “${fuser”， 如 此 在 完成 “领导 分 发 任务 ”后 就 可 以 创建 多 个 “员工 子 任务 ”实例 ， 并 且 用 户 任务 “员工 处 理 任务 ”的 activiti:assignee 属 性 自动 分 配 。 和 “员工 子 任 
务 ” 子 流程 有 关 的 XML 代码 如 下 : 


<subProcess idq="subprocess1" name=" 员 工 子 任务 "> 
<multiInstanceLoopCharacteristics isSequential="false" 
activiti:collection="$ {users}" 
activiti:elementVariable="user"/> 
<startEvent id="startevent2" name="Start" 
activiti:initiator="subProcessStartUser"></startEvent> 
<userTask jiq="usertask1" name=" 员 工 处 理 任务 " 
activiti:assignee="$ {user}"></userTask> 
</subProcess> 


下 面 通过 一 个 简单 的 单元 测试 验证 结果 是 否 和 预期 一 致 ， 见 代码 清单 10-3。 


代码 清单 10-3 ” 子 流程 多 实例 单元 测试 


public class MultiInstanceForSubprocessTest extends SpringActivitiTestCase { 
@Test 
QDeployment (resources = { "diagrams/chapter1l0/multiinstance-for-subprocess.bpmn" }) 
public void testone () throws Exception { 

ProcessInstance ProcessInstance = runtimeService 

.StartProcessInstanceByKey ("multiinstance-for-subprocess"); 

Task task = taskService.createTaskQuery () 

.taskCandidateGroup ("deptLeader") .singleResult () ; 

taskService.claim(task.getId(), "bill"); 

// 完成 任务 "领导 分 发 任务 ” 

Map<String, Object> variables = new HashMap<String, Object> () ， 

List<String> users = Arrays.asList ("userl", "user2", "user3"); 

variables.put ("users", users); 

taskService.complete (task.getId(), variables); 

// 根据 用 户 集合 循环 判断 ， 是 否 每 一 个 用 户 都 有 一 个 待 办 任务 

for (String user : users) 1 
Jong count = taskService.createTaskQuery() .taskAssignee (user) .Count ()，; 
assertEquals (1, count); 


代码 清单 10-3 验 证 了 我 们 的 假设 ， 结 果 是 用 户 集合 users 中 的 每 一 个 用 户 都 有 一 个 待 办 任务 。 


此 例 在 日 常 办 公 场 景 中 出 现 ， 在 代码 清单 10-3 中 通过 设置 一 个 集合 设置 用 户 的 数量 ， 在 实际 应 用 中 可 以 使 用 交互 式 的 组 织 架构 数 选择 某 些 用 户 决定 子 流程 由 哪些 用 户 参与 。 


如 果 把 图 10-20 的 子 流程 更 换 成 调用 活动 也 是 一 样 ， 读 者 可 以 动手 实验 一 下 。 


10.5 本章 小 结 
本 章 重点 讲解 了 子 流程 与 调用 活动 ， 两 者 有 着 相似 的 功能 ， 把 一 些 活动 聚集 起 来 处 理 ， 但 是 两 者 在 引 警 的 实现 上 有 着 很 大 的 差别 ， 本 章 不 仅 从 流程 设计 上 进行 了 分 析 ， 还 对 引 警 的 数据 库 记 录 做 了 深入 
的 讲解 。 


调用 活动 的 目的 是 重用 ， 当 多 个 流程 中 出 现 了 重复 活动 集合 时 就 需要 对 这 一 部 分 重复 活动 集合 进行 抽取 并 设计 一 个 通用 的 流程 ， 在 使 用 方 ( 主 流程) 添加 一 个 调用 活动 引用 通用 流程 即 可 ， 免 除 元 余 的 
设计 也 避免 了 通用 部 分 的 更 改 不 能 和 其 他 流程 同步 的 问题 。 


子 流程 则 不 然 ， 它 没有 像 调用 活动 那样 的 通用 性 ， 它 可 以 把 某 些 任务 归 类 处 理 ， 例 如 把 一 个 流程 划分 为 多 个 阶段 进行 处 理 (阶段 1、 阶 段 2、.……) 。 


事件 子 流程 可 以 说 是 普通 子 流程 的 一 个 特性 分 支 ， 它 只 能 被 事件 驱动 (异常 启动 事件 、 消 息 启动 事件 、 信 号 启动 事件 等 ) ， 通 常用 于 处 理 当前 流程 执行 过 程 中 抛 出 的 事件 ， 只 要 抛 出 的 事件 和 事件 子 流 
程 中 的 启动 事件 匹配 就 可 以 启动 一 个 事件 子 流程 进行 处 理 。 


综 上 所 述 ， 有 了 对 子 流程 及 调用 活动 的 深入 理解 才能 灵活 运用 它们 ， 才 能 根据 需求 对 号 入 座 。 


第 11 章 ”事件 


第 4 章 介绍 了 很 多 目前 Activiti 支 持 的 事件 类 型 ， 有 启动 事件 、 结 束 事件 、 边 界 事件 、 中 间 抛 出 事件 ， 实 战 篇 的 其 他 章 也 陆续 涉及 了 一 些 事件 的 应 用 ， 本 章 将 介绍 其 他 未 涉及 的 事件 ， 带 领 大 家 学 习 如 何 
使 用 事件 以 及 相关 注意 事项 。 


本 章 不 涉及 Explorer， 全 部 以 单元 测试 的 方式 讲解 。 本 章 的 代码 位 于 bpmn20-example 项 目的 me.kafeitu.activiti.chapter11 目 录 中 。 


11.1 ”启动 事件 


启动 事件 应 该 是 最 熟悉 不 过 的 一 种 事件 类 型 了 。 每 个 流程 都 需要 从 一 个 启动 事件 开始 ， 根 据 不 同 的 需求 可 以 选择 使 用 特殊 功能 的 启动 事件 ， 例 如 定时 启动 、 异 常 


ly 
过 
如 
ly 
过 
由 


在 第 10 章 中 涉及 了 异常 启动 事件 ， 这 里 补充 一 下 : 异常 启动 事件 不 能 用 于 主流 程 ， 必 须 府 入 到 事件 子 流程 中 。 
下 面 分 别 介绍 几 种 不 同 的 启动 事件 。 
11.1.1 ”定时 启动 事件 


在 8.2.2 节 的 定时 发 送 邮 件 例子 中 已 经 提 到 了 定时 边界 事件 ， 在 BPMN 2.0 规 范 中 所 有 的 定时 相关 的 定义 都 是 相同 的 ， 定 时 标签 timerEventDefinition 总 是 被 侯 套 在 其 他 的 活动 内 ， 在 定时 发 送 邮件 例子 中 定 
时 标签 欲 套 在 边界 事件 boundaryEvent 中 ， 所 以 称 之 为 定时 边界 事件 。 


如 果 定 时 标签 嵌 套 在 启动 事件 startEvent 内 ， 就 构成 了 一 个 定时 启动 事件 ， 还 可 以 用 相同 的 方式 把 其 他 的 事件 嵌入 到 startEvent 中 ， 例 如 异常 启动 事件 、 消 息 启 动 事件 、 信 号 启动 事件 等 。 


图 11-1 展 示 的 是 一 个 用 定时 启动 事件 引导 的 流程 ， 这 个 流程 演示 了 如 何 定义 以 及 触发 定时 启动 事件 。 


Service Task 


EA 
Recelve Task 


图 11-1 包含 定时 启动 事件 的 流程 


在 Activiti Designer 中 ， 从 右 侧 拖 动 “TimestartEvent” 到 工作 区 ， 单 击 事件 的 图 标 在 “Properties” 视 图 中 可 以 看 到 如 图 11-2 所 示 的 设置 。 


Time duration 


Main config 


Time date (I5O 8601) 
Form 


Time cycle 


图 11-2 ”定时 启动 事件 的 配置 


在 图 11-2 中 设置 了 “Time duration” 属性， 对 应 的 XML 代码 如 下 ， 和 8.2.2 节 的 定时 发 送 邮件 的 配置 异曲同工 。 


<startEvent id="timerstarteventl" name="Timer start"> 
<timerEventDefinition> 

<timeDuration>PT5M</timeDuration> 

</timerEventDefinition> 


</startEvent> 


定时 启动 事件 可 以 应 用 在 很 多 场景 ， 例 如 固定 每 个 月 的 1 号 启动 一 个 月 度 财务 报表 流程 ， 在 生成 报表 后 创建 一 个 待 办 任务 给 财务 (或 者 其 他 职位 ) 办 理 ， 检 验 无 误 后 再 提交 给 总 经 理 ， 最 后 发 布 报表 ， 如 
图 1 1 -3 所 示 。 


图 11-3 报表 审阅 流程 


回归 正题 ， 利 用 单元 测试 的 方式 模拟 一 个 定时 启动 流程 ， 根 据 断 言 的 状态 了 解 定 时 启动 事件 的 原理 ， 如 代码 清单 11-1 所 示 。 


代码 清单 11-1 定时 启动 事件 单元 测试 


public class TimerStartEventTest extends PluggableActivitiTestCase { 

QDeployment (resources = "chapterll/timerEvent/timerStartEvent .bpmn") 

public void testTriggerAutomatic () throws Exception { 
// 创建 定时 作业 查询 对 象 
JobQuery jobouery = managementService.createJobQuery (); #1-S 
assertEquals (1, jobQuery.count ()); #1-E 
// 模拟 时 间 5 分 钟 之 后 
SimpleDateFormat sdf = new SimpleDateFormat ("hh:mm:ss"); #2-S 
System.out.println ("http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15030/0EBPS/Text/..http://www.hzcourse.com/resource/readBook?patt 
ClockUtil.setCurrentTime (new Date (System.currentTimeMillis() 


+ ((50 * 60 * 1000) + 5000))); 
waitForJobExecutorToProcessAllJobs (5000L, 1L); // 等 待 5 秒 钟 
System.out.println ("http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15030/0EBPS/Text/..http://www.hzcourse.com/resource/readBook?pattr 
assertEquals (0，jobQuery.count ()); // 5 分 钟 之 后 流程 已 经 启动 ， 同 时 删除 一 条 作业 记录 ， 加 

// 所 以 此 时 定时 作业 记录 为 空 
// 检查 是 否 启动 了 流程 实例 


long count = runtimeService.createProcessIinstanceQuery () #3-S 
.ProcessDefinitionKey ("timerStartEvent") .Count (); 
assertEquals (1, count); #3 一 E 


#1 处 通过 调用 org.activitiengine.ManagementSservice 的 createJobQuery() 方 法 创建 JobQuery 对 象 实例 查询 引擎 数据 库 的 定时 作业 。 


#2 处 利用 引 警 提供 的 测试 基 类 的 工具 方法 用 5 秒 钟 模拟 5 分 钟 (方便 快速 执行 单元 测试 ， 不 需要 真 的 等 待 5 分 钟 ) 之 后 ， 引 警 会 以 轮 询 的 方式 查询 作业 表 是 否 有 和 当前 时 间 匹 配 的 作业 ， 如 果 匹 配 ， 则 执 
行 作 业 (也 可 手动 执行 作业 ) 。 


执行 完 测试 之 后 将 会 看 到 类 似 如 下 的 输出 ， 从 输出 结果 可 以 看 出 开始 与 结束 时 间 相 差 5 秒 钟 。 最 后 在 #3 处 根据 流程 1D 统计 正常 运行 的 流程 实例 数量 ，count 的 值 为 1 表示 引擎 自动 启动 了 图 11-1 的 流程 。 


可 能 还 有 人 不 知道 引擎 在 什么 时 间 创 建 了 定时 作业 ”答案 是 在 部 署 流程 之 后 ， 引 擎 对 部 署 的 流程 定义 做 一 些 初始 化 的 工作 ， 其 中 就 包含 了 对 定时 作业 的 注册 (插入 一 条 定时 作业 记录 ) ， 还 有 对 消息 事 
件 (将 在 11.3.2 节 讲解 ) 的 注册 ， 等 等 。 


http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15030/0EBPS/Text/..http://www.hzcourse.com/resource/readBook?path=/openresources/teach ek 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15030/0EBPS/Text/..http://www.hzcourse.com/resource/readBook?path=/openresources/teach er 


通过 定时 启动 事件 自动 启动 流程 的 确 很 实用 ， 但 是 有 过 定时 作业 经 验 的 读者 可 能 会 问 : 如 果 一 个 作业 计划 在 明天 早上 8 点 执行 ， 但 是 由 于 其 他 特殊 原因 需要 提前 触 友 ， 这 该 如 何 处 理 呢 ? 对 于 这 种 情况 
Activiti 引 人 擎 允许 通过 手动 方式 〈 即 调用 API) 执行 作业 。 代 码 清单 11-2 演 示 了 如 何 手动 执行 一 个 作业 。 


代码 清单 11-2 ”手动 执行 作业 


QDeployment (resources = "chapter11/LimerEvent/LimerStartEvent .bpmn'" ) 
public void testTrigoerManual () throws Exception { 
JobQuery jobQuery = managementService.createJobQuery (); 


assertEquals (1, jobQuery.count ()); 

// 多 仍 发 从 此 的 贡生 

Job job = jobQuery.singleResult () ， 

managementService.executeJob (job.getId()); // 手动 执行 作业 

assertEquals (0, jobQuery.count () ) 

// 检查 是 关 司 动 了 沪 窟 实 们 

long count = runtimeService.createProcessIinstanceQuery () 
.processDefinitionKkey ("timerStartEvent") .count () ， 

assertEquals (1, count); 


代码 清单 11-2 和 代码 清单 11-1 大 致 相同 ， 唯 一 不 同 的 是 把 模拟 5 分 钟 的 代码 更 换 成 通过 API 手 动 调用 执行 作业 ， 这 样 不 管 作业 计划 在 何 时 执行 executeJob0 方 法 都 会 立即 执行 作业 。 
代码 清单 11-1 和 代码 清单 11-2 演 示 的 都 是 在 部 署 流程 5 分 钟 之 后 执行 作业 ， 也 可 以 参考 表 4-2 设 置 不 同 的 参数 来 决定 作业 如 何 执行 ， 例 如 定时 一 次 性 (具体 到 某 一 天 某 一 秒 ) 、 周 期 性 执行 。 


可 以 把 timerStartEvent.bpmn 文 件 部 署 到 Activiti Explorer 中 ， 然 后 在 “Manage” 一 “Database” 视 图 中 查看 ACT_RU_JOB 表 的 数据 ， 如 图 11-4 所 示 (因为 排版 问题 分 割 成 上 下 两 部 分 ) 。 


图 AcTr_ Ru JoB 


EXECUTION ID PROCESS_IMNSTANCE_ID_ 


EXCEPTION STACK ID_ EXCEPTION MSG_ ] DUEDATE _ REPEAT_ | HANDLER TYPE_ 


2013-02-25 2301:40.695 tmer-start-event timerSstartEvent 


图 11-4 ACT_RU_JOB 表 的 数据 
表 11-1 列 出 了 ACT_RU_JOB 表 的 一 些 关键 字段 的 含义 。 


表 11-1 ACT_RU_JOB 表 的 主要 字段 说 明 


字段 名 称 属性 说 明 
TYPE 作业 类 型 ， 有 message 和 timer 两 种 类 型 
RETRIES _ 徙 发 失败 后 最 大 车 试 次 数 ， 也 可 以 通过 调用 ManagementService#setJobRetries 方法 设置 
DUEDATE_ 执行 时 间 。3 引 | 擎 正 是 将 此 字段 与 当前 时 间 进 行 比 较 ， 相 同 或 已 超过 则 执行 作业 


作业 的 处 理 类 型 。 对 于 每 一 种 类 型 都 有 对 应 的 处 理 帮 (handler)， 目 前 引擎 支持 的 类 型 有 : 
口 event: 事件 

D timer-start-event: 定时 启动 事件 

D timer-transition: 边界 定时 事件 


HANDLER_TYPE_ 


字段 名 称 属性 说 明 


D timer-intermediate-transition: 定时 中 间 事 件 


a 
HANDLER_LTYPE_ 口 async-continuation: 异步 执行 的 作业 


HANDLER CFG _ 作业 的 日 标 ， 和 HANDLER TYPE 联合 起 来 决定 执行 哪个 流程 定义 的 哪个 作业 处 理 类 型 


11.1.2 ”消息 启动 事件 


消息 启动 事件 和 第 10 章 介绍 的 事件 子 流程 中 涉及 的 异常 启动 事件 类 似 ， 都 是 通过 一 个 特定 的 消息 标志 触发 事件 。 一 个 简单 的 消息 启动 事件 引导 的 流程 如 图 11-5 所 示 。 


图 11-5 消息 启动 事件 流程 图 示例 


使 用 Activiti Designer 设 计 消 息 启动 事件 的 方式 与 设计 异常 启动 事件 不 同 ， 对 于 异常 启动 事件 ， 只 要 选择 后 设置 “ERROR_CODE” 就 可 以 了 ， 而 对 于 消息 类 型 事件 ， 需 要 先 在 流程 中 预 设 一 个 消息 ,之 
后 才能 在 消息 类 型 的 事件 上 进行 配置 (下拉 框 形式 选择 ) 。 


单 击 流程 设计 工作 区 的 空白 处 (不 要 选择 任何 元 素 ) ， 单 击 “Properties” 标 签 页 的 “Messages” 子 标签 可 以 看 到 如 图 11-6 所 示 的 界面 。 


外电 


图 11-6 ”流程 消息 定义 界面 


单 击 图 11-6 的 “New” 按 钮 会 弹出 图 11-7 的 对 话 框 , 填写 “Id” 和 “Name” 属 性 。 


图 11-7 添加 消息 对 话 框 


单 击 图 11-7 的 “OK” 按钮 即 可 添加 一 个 消息 至 流程 ， 对 应 地 ， 设 计 器 会 在 XML 中 添加 一 个 “< message../>” 标 签 。 成 功 添加 消息 定义 之 后 即 可 看 到 如 图 11-8 所 示 的 列表 。 


外 Marker | 国 Proper 器 上 Server 国 Consol Bm Progre 才 Search 上 JUnit 


rs 


Messages: 


Narme 
启动 XXX 流程 


Messages 


图 11-8 消息 列表 


完成 定义 之 后 单 击 消息 启动 事件 ， 在 “Message” 视 图 可 以 看 到 如 图 11-9 所 示 的 界面 。 单 击 “Message Ref Id” 后 面 的 下 拉 框 可 以 选择 刚刚 定义 的 消息 ， 即 图 11-8 列 表 中 的 所 有 消息 ， 最 后 选 
择 “MSG_001/ 启 动 XXX 流 程 ” 就 完成 了 消息 启动 事件 的 配置 。 


本 Ma 国 放 加 晃 $ 国 C 


Message Ref ld 


Main config MSG_001 / 启动 YOOX 流程 


图 11-9 ”为 消息 启动 事件 设置 消息 类 型 
完成 了 流程 设计 之 后 Activiti Designer 会 生成 XML 内 容 ， 如 代码 清单 11-3 所 示 。 


代码 清单 11-3 图 11-5 的 XML 代码 


<definitions http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15030/0EBPS/Text/...> 
<message igd="MSG 001" name=" 启 动 XXX 流 程 "></message> 
<process id="messageStartEvent" name="messageStartEvent" isExecutable="true"> 
<startEvent id="messagestarteventl" name="Start"> 
<messageEventDefinition messageRef="MSG 001"></messageEventDefinition> 
</startEvent> 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15030/0EBPS/Text/... 
</process 
</definitions> 


代码 清单 11-3 中 加 粗 部 分 的 XML 代码 就 是 Activiti Designer 生 成 的 ， 其 中 <message/> 的 “id” 属 性 的 作用 是 在 流程 定义 文件 内 部 引用 ,而 “name” 属 性 才 是 启动 流程 时 的 参数 。 以 消息 启动 事件 引导 
的 流程 启动 方式 和 之 前 介绍 的 启动 流程 的 API 有 所 不 同 。 代 码 清单 11-4 列 出 了 通过 消息 名 称 启动 流程 实例 的 方法 。 


代码 清单 11-4 ”启动 消息 启动 事件 引导 的 流程 


public class MessageEventTest extends PluggableActivitiTestCase { 
QDeployment (resources = "chapterll/messageEvent/messageStartEvent .bpmn") 
public void testMessageEvent () throws Exception { 
ProcessInstance pi = runtimeService.startProcessInstanceByMessage ("启动 XXX 流 程 ")，; 
assertNotNull (pi); 
} 
} 


是 不 是 以 消息 启动 事件 引导 的 流程 必须 使 用 代码 清单 11-4 的 方式 启动 呢 ? 也 不 尽 然 ， 也 可 以 使 用 空 启动 事件 的 启动 方式 启动 流程 ， 当 然 这 种 方式 对 流程 定义 有 一 定 的 限制 : 流程 中 只 能 包含 一 个 消息 启 
动 事件 。 例 如 ， 代 码 清单 11-5 通 过 startProcesslnstanceByKey() 方 法 来 启动 一 个 流程 实例 。 也 可 以 在 查询 到 流程 定义 ID 之 后 调用 startProcesslnstanceByld() 方 法 启动 流程 。 


代码 清单 11-5 ”通过 流程 ID 启动 流程 


public void testStartMessageEventByKey() throws Exception { 
ProcessInstance pi = runtimeService.startProcessInstanceByKey ("messageStartEvent"); 
assertNotNull (pi); 


我 们 知道 ， 定 时 启动 事件 可 以 按照 预 设 时 间 启 动 是 因为 引擎 不 断 刷新 数据 库 表 ACT_RU_JOB 的 记录 ， 根 据 时 间 匹 配 作业 ， 命 中 之 后 就 执行 作业 。 对 消息 也 采用 类 似 的 机 制 ， 在 部 署 流程 之 后 引擎 会 在 初 
始 化 中 处 理 消息 事件 ， 把 消息 的 类 型 注册 到 数据 库 (插入 消息 记录 到 表 ACT_RU_EVENT_SUBSCR) ， 在 流程 执行 过 程 中 遇 到 了 消息 类 型 事件 或 通过 API 触 发 消息 事件 会 从 该 表 读 取 数 据 ， 并 且 根 据 消息 的 属 
性 调用 消息 处 理 器 。 


图 11-10 展 示 了 表 ACT_RU_EVENT_ SUBSCR 的 表 记 录 。 


| ACT_RU EVENT SUBSCR 


EVENT_TYPE_ EWVENT NAME_ EXEGUTION ID_ PROC INST_ID_ ACTIVITY ID_ GONFIGURATION_ 


Message 启动 XGO 流程 Messagestartewventi messagestarEvent:181 


图 11-10 ” 表 ACT_RU_EVENT_SUBSCR 
下 面 列 出 每 个 字段 的 含义 ， 以 帮助 读者 从 中 理解 引擎 处 理 消息 事件 的 原理 。 
-EVENT _TYPE_ : 事件 类 型 。message 表 示 消 息 类 型 。 
EVENT_NAME_: 消息 名 称 。 和 触发 消息 时 引擎 会 根据 消息 名 称 参 数 和 这 个 字段 进行 匹配 。 
“ EXECUTION_ID_: 实例 执行 ID。 如 果 一 个 流程 以 消息 启动 事件 引导 ， 则 此 字段 为 空 ， 如 果 在 流程 运行 中 注册 了 消息 事件 ， 则 此 字段 保存 流程 执行 ID。 
. PROC_INST _ID_ : 流程 实例 ID。 同 EXECUTION_ID_， 只 不 过 保存 的 是 流程 实例 ID (与 EXECUTION 是 一 对 多 的 关系 ) 。 
.ACTIVITY ID_: 活动 ID。 如 果 根 据 字 段 EVENT_NAME 匹配 到 消息 就 应 该 触发 哪个 活动 。 
CONFIGURATION_: 消息 的 配置 信息 。 对 于 消息 类 型 来 说 这 里 保存 的 是 流程 定义 ID。 
根据 对 字段 的 解释 已 经 很 清楚 引 警 是 如 何 处 理 消 息 事 件 的 了 : 当 我 们 调用 startProcess-InstanceByMessage 方 法 时 ， 根 据 匹 配 规则 就 能 触发 消息 启动 事件 ， 从 而 启动 一 个 流程 实例 。 
另外 字段 EXECUTION ID 与 PROC _INST_ID 不 为 空 的 情况 将 在 11.3.2 节 的 消息 边界 事件 应 用 中 介绍 。 
根据 消息 名 称 启动 流程 (代码 清单 11-3) 可 能 会 遇 到 如 下 的 运行 时 异常 ， 原 因 是 对 应 的 消息 名 称 不 存在 。 


| 


org.activiti.engine.ActivitiException: Cannot start process instance by message: no subscription to message with name ' 启 动 付 费 流 程 ' found. 


遇 到 这 样 的 问题 我 们 会 想到 先 从 数据 库 查 询 是 否 已 经 注册 过 名 称 为 “启动 付费 流程 ”的 消息 ， 有 则 启动 ， 没 有 则 提示 用 户 启动 流程 失败 。 
不 过 目前 Activiti 引 擎 没有 公开 提供 查询 消息 的 接口 ， 所 以 我 们 要 利用 非 公 开 的 查询 类 查询 消息 列表 ， 如 代码 清单 11-6 所 示 。 


代码 清单 11-6 ”查询 对 应 的 消息 是 否 存 在 


QDeployment (resources = "chapterll/messageEvent/messageStartEvent .bpmn") 
public void testMessageSubcription() throws Exception 1{ 
EventSubscriptionQuerylimpl eventSubscriptionQuery = new EventSubscriptionQueryImpl ( 


processEngineConfiguration.getCommandExecutor ()); 

EventSubscriptionEntity subscriptionEntity = eventSubscriptionQuery 
.eventName ("启动 XXX 流 程 ") .singleResult (); 

assertNotNull (subscriptionEntity); 


11.2 ”结束 事件 


终止 结束 事件 (4.1.3 节 ) 和 空 结束 事件 最 大 的 区 别 就 是 前 者 可 以 终止 整个 流程 实例 的 执行 ， 而 后 者 只 结束 一 条 输出 流 的 执行 。 


图 11-11 所 示 的 流程 图 包含 一 个 终止 结束 事件 ， 启 动 事件 后 面 并 行 网 关 的 两 个 输出 流 分 别 执行 一 个 子 流程 和 “主任 务 A”， 在 “主任 务 A” 完 成 后 终止 结束 事件 将 被 触发 ， 从 而 终止 流程 实例 的 执行 ， 此 
时 从 历史 任务 中 查询 到 流程 实例 状态 为 已 完成 。 


Sub Process 


图 11-11 包含 终止 结束 事件 的 流程 


通过 两 个 简单 的 测试 可 以 快速 理解 终止 结束 事件 的 作用 ， 以 及 对 流程 数据 的 影响 : 第 一 个 单元 测试 (代码 清单 11-7) 先 把 子 流程 执行 完成 ， 然 后 再 完成 主流 程 的 用 户 任务 “主任 务 A” ;第 二 个 单元 测 
试 (代码 清单 11-8) 直接 完成 “主任 务 A” 结 束 流程 实例 的 执行 ， 然 后 观察 这 两 种 不 同 的 执行 顺序 对 流程 数据 的 影响 。 


代码 清单 11-7” 先 完成 子 流程 再 完成 “主任 务 A” 


QDeployment ("chapter1ll/terminateEndEvent/terminateEndEventWithSubprocess .bpmn") 

public void testone () throws Exception { 
ProcessInstance ProcessInstance = runtimeService 

.StartProcessInstanceByKey ("terminateEndEeventWithSubprocess"); 

assertNotNull (processInstance); 

// 查询 名 称 为 ` 子 任务 A” 的 任务 

Task task = taskService.createTaskQuery() .taskDefinitionKey ("subTask") .singleResult () ; 

taskService.complete (task.getId()); 

// 完成 主流 程 用 户 任 务 

task = taskService.createTaskQuery () .taskDefinitionKey ("masterTask") .singleResult ()，; 

taskService.complete (task.getId()); 

checkFinished (processInstance); 


代码 清单 11-7 中 的 checkFinished() 方 法 的 代码 如 下 ， 用 于 监测 流程 状态 和 输出 结果 。 


private void checkFinishedq(ProcessInstance processInstance) { 
// 验证 流程 已 结束 
HistoricProcessInstance hpi = historyService 
.CreateHistoricProcessInstanceQuery () 
.ProcessInstanceId (ProcessInstance .getId() ) 
.SingqlLleResult() ， 
assertNotNull (hpi .getEndTime () ) ， 
// 查询 历史 任务 
LiSst<HiSstoricTaskInstance> list = historyService 
.createHistoricTaskInstanceQuery() .list (); 
for (HistoricTaskInstance hti : list) { 
System.out.println(hti.getName() + " " 
+ hti.getDeleteReason ()); 


} 

// 流程 结束 后 校 验 监听 器 设置 的 变量 

HistoricVariableInstance vi = historyService 
.CreateHistoricVariableInstanceQuery () 
.variableName ("settedonEnd") .singleResult ();，; 

assertEquals (true, vi.getValue()); 


图 说 明 如 果 主 流程 设置 了 “end” 监 听 器 ， 在 流程 终止 时 将 被 调用 。 


运行 完 代码 清单 11-7 的 单元 测试 之 后 控制 台 会 打印 如 下 内 容 : 


子 任务 A completed 
主任 务 A completed 


解释 一 下 输出 的 “completed”， 如果 一 个 任务 正常 完成 ( 即 通 过 调用 taskService.complete() 方 法 ) ， 历 史 任 务 对 象 的 删除 原因 (属性 deleteReason 的 值 ) 为 “completed”， 如 果 任 务 被 删除 ， 则 
删除 原因 为 “deleted”。 


从 代码 清单 11-7 中 可 能 看 不 出 有 什么 特别 的 地 方 ， 接 着 来 看 代码 清单 11-8 的 测试 代码 ， 直 接 完成 用 户 任务 “主任 务 A” ， 再 观察 数据 结果 与 代码 清单 11-7 的 输出 结果 有 何不 同 。 


代码 清单 11-8 直接 完成 “主任 务 A” 结 束 流 程 


public void testSecond() throws Exception { 
ProcessInstance ProcessInstance = runtimeService 
.StartProcessInstanceByKey ("terminateEndEeventWithSubprocess"); 
assertNotNull (processInstance); 
// 完成 主流 程 用 己任 务 
Task task = taskService.createTaskQuery () 
.taskDefinitionKey ("masterTask") .singleResult () ， 
taskService.complete (task.getId()); 
checkFinished (ProcessInstance) ， 


Er 


先 观察 输出 结果 ， 然 后 再 解释 为 什么 结果 和 代码 清单 11- 7 不 同 。 


子 任务 A deleted 
主任 务 A completed 


“ 子 任务 A” 的 删除 原因 为 “deleted”,， 与 “主任 务 A” 的 删除 原因 不 同 。 刚 刚 解 释 了 任务 被 删除 的 原因 为 “deleted”， 由 此 可 以 看 出 在 终止 结束 事件 被 执行 后 所 有 处 于 运行 中 的 任务 都 将 被 删除 (如 
果 有 监听 器 也 会 被 调用 ) 。 


11.3 ”边界 事件 
边界 事件 应 该 是 实际 应 用 中 比较 常用 的 事件 类 型 。 利 用 边界 事件 可 以 以 “插件 式 ” 为 活动 添加 附件 (边界 事件 总 是 附加 在 某 一 个 活动 上 ) 事件 ， 比 如 ， 在 第 8 章 中 利用 定时 边界 事件 自动 发 送 销假 超时 提 
醒 邮 件 ， 在 第 10 章 中 利用 异常 边界 事件 对 付费 异常 进行 处 理 。 


本 节 内 容 将 深入 介绍 边界 事件 的 其 他 特性 ， 并 补充 讲解 前 面 章节 未 涉及 的 其 他 边界 事件 。 


11.3.1 ”异常 边界 事件 


在 第 10 章 中 利用 异常 边界 事件 处 理 付费 子 流程 的 异常 情况 看 起 来 很 优雅 ， 也 是 中 规 中 矩 的 ， 为 什么 这 么 说 呢 ” 因 为 我 们 可 以 让 触发 异常 边界 事件 更 “Geek”。 第 10 章 的 例子 是 在 付费 子 流程 中 利用 异 
结束 事件 抛 出 异常 信息 ， 如 果 一 个 异常 附加 在 用 户 任务 或 者 Java service 任务 上 该 如 何 抛 出 异常 事件 呢 ? 


首先 来 看 图 11-12 所 示 的 流程 图 ， 在 “自动 执行 系统 任务 ”上 附加 了 一 个 异常 边界 事件 ， 在 捕获 到 异常 后 输出 流 指向 用 户 任务 “处 理 异 常 ”， 人 处 理 完 此 任务 后 表 次 执行 “自动 执行 系统 任务 ”， 此 
时 “自动 执行 系统 任务 ”会 执行 一 个 实现 了 JavaDelegate 接 口 的 类 ， 根 据 设 定 的 业务 逻辑 决定 何 时 抛 出 异常 。 


Gs 


日 动 执行 系统 任务 


AIA _ERROR ny 


图 11-12 手动 抛 出 异常 事件 


了 解 了 流程 处 理 过程 之 后 再 来 看 看 该 流程 的 XML 代码 ， 这 里 只 列 出 了 关键 部 分 


<process id="throwErrorManual" name="throwErrorManual" isExecutable="true"> 
<serviceTask id="servicetaskl" name=" 自 动 执行 系统 任务 " 
activiti:class="me.kafeitu.activiti.chapter1l1 
.listener.ThrowErrorManaualService" /> 
<boundaryEvent id="boundaryerrorl" name="Error" 
attachedToRef="servicetaskl"> 
<errorEventDefinition errorRef="AIA ERROR 99"/> 
</boundaryEvent> 四 加 
</process> 


从 上 面 的 代码 清单 中 可 以 看 出 图 11-12 的 “自动 执行 系统 任务 ”执行 一 个 Java 类 ( 见 代 码 清单 11-9) ， 附 加 的 异常 边界 事件 捕获 的 错误 代码 为 “AlA_ERROR_99”。 代 码 清单 11-10 对 本 节 开 始 的 执行 过 
程 进行 了 模拟 与 验证 。 


代码 清单 11-9 ”直接 完成 “主任 务 A” 结 束 流 程 


public class ThrowErrorManaualService implements JavaDelegate { 


QOverride 
public void execute (DelegateExecution execution) throws Exception 
if (execution. Se enn ed == null) { // 区 全 的 人 为 空 束 抛 出 异常 
throw new BpmnError ("AIA OR .997 ) 过 


} // 抛 出 一 57 对 良好 可 手动 下 出 异常 常 ， 从 而 使 异常 被 附加 在 任务 上 的 
} // 异常 边界 事件 捕获 
} 


代码 清单 11-10 ”手动 抛 出 异常 


public class ThrowErrorManualTest extends PluggableActivitiTestCase { 
QDeployment (resources = "chapter1l1/boundaryEvent/throwE 'rrorManual .bpmn") 
public void testThrowErrorManual() throws Exception 1{ 

ProcessInstance ProcessInstance = runtimeService 
.StartProcessInstanceByKey ("throwErrorManual"); 
assertNotNull (processInstance); 

// 流转 至 用 户 任 务 
Task task = taskService.createTaskQuery () .singleResult () ; 

Map<String, Object> Variadles = = new HashMap<String, Object>(); 

variables.put ("pass"，true); // 完成 任务 时 设置 pass 变 量 ， 使 其 值 不 为 null 
taskService.complete (task.getId(), variables); 

// 流程 执行 完成 

long count = historyService.createHistoricProcessInstanceQuery() .finished() .count (); 
assertEquals (1, count); 


结合 代码 清单 11-9 和 代码 清单 11-10 的 单元 测试 明白 了 如 何 手动 抛 出 异常 ， 从 而 可 以 根据 流程 数据 处 理 复杂 的 业务 逻辑 。 


11.3.2 ”消息 边界 事件 


~/ 


消息 边界 事件 与 异常 边界 事件 有 着 类 似 的 触发 方式 ， 可 以 调用 RuntimeService 的 接口 触发 消息 边界 事件 。 


图 11-13 展 示 了 包含 消息 边界 事件 的 流程 图 ， 附 加 在 用 户 任务 “审核 文件 ”的 消息 边界 事件 可 以 捕获 该 任务 触 友 (也 可 以 称 之 为 抛 出 ) 的 消息 事件 。 


Markers 国 Properties 器 几 Servers 国 Console i Progress “Search 


Messages: 


上 可 Name 


MSG_HELP 协助 处 理 


Messages 
ey 


图 11-13 ”包含 消息 边界 事件 的 文档 审批 流程 图 
下 面 的 代码 清单 列 出 了 图 11-13 中 关键 的 XML， 而 消息 边界 事件 监听 的 消息 名 称 可 以 参考 图 11-14 的 界面 进行 设置 ， 注 意 边 界 事件 的 “cancelActivity” 属 性 的 值 为 “true”。 


<message id="MSG HELP" name="MSG 协助 处 理 "></message> 
<process id="messageBoundaryEvent" 
name="messageBoundaryEvent" isExecutable="true"> 
<userTask id="usertaskl1" name=" 审 核 文 件 "></userTask> 
<boundaryEvent id="boundarymessagel" name="Message" 
attachedToRef="usertaskl" cancelActivity="true"> 
<messageEventDefinition messageRef="MSG HELP" /> 
</boundaryEvent> 
<userTask id="usertask2" name=" 协 助 处 理 "></userTask> 
</process> 


et Markers fs Properties 2 4 Servers El] Console ED Progress 
| 


Gene | Cancelactivity true 


图 11-14 设置 消息 边界 事件 属性 


消息 边界 事件 、 信 和 号 边界 事件 与 异常 边界 事件 会 多 出 一 个 “cancelActivity” 属 性 ， 此 属性 可 以 取 值 true 或 false。 下 面 对 “cancelActivity” 属 性 的 不 同 取 值 做 出 了 说 明 。 
.true: 在 消息 边界 事件 触发 后 取消 已 注册 的 消息 事件 。 
. false: 在 消息 边界 事件 触发 后 仍然 保留 已 注册 的 消息 事件 ， 可 以 再 次 触发 。 


下 面 分 别 介 绍 cancelActivity 属 性 取 不 同 值 时 所 产生 的 不 同 结 果 。 


1. 单 次 触发 


图 11-13 的 流程 业务 逻辑 很 简单 ， 假 设 员工 需要 提交 一 个 文件 给 领导 审核 ， 在 启动 流程 时 上 传 附件 启动 流程 ， 在 领导 审核 过 程 中 需要 他 人 协助 处 理 ， 可 以 通过 发 送 消息 的 方式 把 任务 转交 出 去 ， 等 处 理 
完 再 回归 到 “审核 文件 ”用 户 任 务 。 


下 面 通过 单元 测试 的 方式 模拟 这 个 假设 的 业务 流程 ， 见 代码 清单 11-11 所 示 。 


代码 清单 11-11 消息 边界 事件 单元 测试 


public class ReceiveMessageManualTest extends PluggableActivitiTestCase { 
QDeployment (resources = "chapterll/boundaryEvent/messageBoundaryEvent .bpmn") 
public void testReceiveMessageManual() throws Exception { 
runtimeService.startProcessiInstanceByKey ("messageBoundaryEvent"); 
// 审核 文件 任务 
Task task = taskService.createTaskQuery () .taskName ("审核 文件 ") .singleResult () ; 
assertNotNull (task); 
ExecutionQuery executionQuery = runtimeService.createExecutionQuery () ， #1-S 
Execution exeuction = executionQuery 
.messageEvent tSubscriptionName (' 'MSG 协助 处 理 ") .singleResult () ; 
runtimeService.messageEventReceived ("MSG 协助 处 理 "，exeuction.getId());  #1- 忆 
// 任务 到 达 、 \ 协 助 处 强 节 点 ” 
task = taskService.createTaskOuery () .taskName ("协助 处 理 ") .singleResult () ;#2-5S 
assertNotNull (task); 
taskService. SO ls getId()); #2-E 
// 任务 流转 至 “审核 文件 “节点 
task = taskService.createTaskQuery () .taskName ("审核 文件 ") .singleResult () ; #3 
assertNotNull (task); 


代码 清单 11-11 中 #1 处 的 3 行 代码 在 这 里 第 一 次 接触 到 ， 其 中 #1-S 处 的 Execu-tionQuery 查 询 对 象 是 专门 为 查询 流程 执行 对 象 (Execution， 与 Processlnstance 是 多 对 一 的 关系 ) 设计 的 ， 这 里 使 用 
ExecutionQuery 对 象 查询 的 原因 是 引擎 遇 到 有 附加 消息 边界 事件 的 任务 时 会 创建 一 个 执行 对 象 来 监听 消息 事件 的 触发 动作 。 图 11-13 的 流程 启动 之 后 紧 接着 就 会 创建 名 称 为 “审核 文件 ”的 用 户 任务 (Task 
对 象 ) ， 在 创建 过 程 中 检测 到 存在 附加 的 消息 边界 事件 就 会 创建 一 个 执行 实例 ， 同 时 会 和 消息 启动 事件 一 样 在 引擎 中 注册 一 个 消息 。 


文件 描述 总 归 是 抽象 的 ， 而 观察 数据 记录 ( 见 图 11-15) 有 助 于 理解 这 一 过 程 。 表 ACT_RU_EVENT_SUBSCR 中 的 记录 的 消息 名 称 和 图 11-13 中 的 消息 边界 事件 的 名 称 匹配 。 注 意 ， 该 记录 
的 “EXECUTION_ID ”和 “PROC_INST_ID ”字段 的 值 不 为 空 ， 这 与 11.1.2 节 中 的 消息 启动 事件 不 同 。 这 两 个 字段 的 值 也 是 不 同 的 ， 观 察 表 ACT_RU_EXECUTION 的 记录 可 以 说 明 这 一 点 ，ID 为 70 的 记录 
是 由 ID 为 67 的 记录 创建 的 (通过 PARENT ID 字段 可 以 证 明 ) 。 另 外 还 需 注意 ACT_RU_EXECUTION 的 两 条 记录 的 “ACT ID (表示 一 个 执行 对 象 的 当前 活动 ) ”和 “IS_ACTIVE (是 否 处 于 活动 状 
态 ) ”字段 值 不 同 ， 也 就 是 说 主流 程 挂 起 ， 监 听 消 息 的 执行 对 象 处 于 活动 状态 。 


EVENT_NAME EXECUTION ID _ PROC INST ID_ ACTVITY ID_ 


Message 协助 处 理 0 67 boundarymessagel 


ACT_RU EXECUTION 


PROG INST ID -| BUSINESS KEY_ PARENT_ID_ PROG_ BEF_IG_ SUFER EXEG | AGT ID I_AGTIVE_ 


messageBoundaryEvent:1:66 false 


messageBoundaryEvent:166 usertask1 true 


图 11-15 ”启动 了 图 11-13 的 流程 之 后 数据 记录 


根据 前 面 假设 的 业务 流程 现在 应 该 把 任务 流转 到 “协助 处 理 ” 节 点 ， 代 码 清单 11-11 的 1-E 处 通过 调用 API 方 法 触发 了 名 称 为 “MSG 协助 处 理 ”的 消息 事件 (此 时 取消 了 已 注册 的 消息 事件 ) ， 消 息 边 界 
事件 的 输出 流 指向 了 “协助 处 理 ” 用 户 任务 ， 所 以 在 #2 处 查询 到 该 任务 并 完成 任务 办 理 ， 最 后 在 #3 处 验证 了 任务 回归 到 “审核 文件 ”节点 。 


图 11-16 用 流程 图 的 形式 展示 了 该 流程 的 执行 过 程 ， 并 说 明了 每 个 步骤 做 的 任务 。 


cancelActivity="true" 


人 


尾 务 : 审核 文件 


J 步 又 


创建 任务 实例 


)、 注册 消息 过 界 事件 


图 11-16 


不 触发 事件 直接 完成 任务 


注意 “如果 一 个 任务 有 附加 的 消息 边界 事件 ， 当 任务 执行 完成 且 边界 事件 没有 被 触发 ， 那 么 


2. 多 次 触发 


多 次 触发 是 相对 于 单 次 触发 来 说 的 ， 即 设置 “cancelActivity” 属 性 为 false， 


注册 的 消息 事件 ) 。 


为 了 介绍 多 次 触发 ， 特 意 在 messageBoundaryEvent.bpmn 的 基础 上 更 改 cancelActivity 的 值 为 “false” 


图 11-17 模 拟 的 是 多 次 触发 事件 的 执行 过 程 ， 与 图 11-16 相 比 稍微 有 些 区 别 ， 移 除了 “ 触 上 友 (多 次 ) 消息 ”后 面 的 虚线 ， 也 就 是 说 引 


代码 清单 11-12 是 根据 图 11-17 的 执行 过 程 进 


行 模 拟 ， 


代码 清单 11-12 ”多 次 触发 消息 边界 事件 单元 测试 


过 数据 来 分 析 多 次 触发 后 流程 数据 的 变化 。 


包含 消息 边界 事件 的 流程 执行 过 程 


经 注册 的 事件 将 在 任务 完成 时 被 删除 。 


这 样 在 触发 了 消息 边界 事件 之 后 继续 保留 已 注册 的 事件 ， 可 以 连 


触发 消息 


取消 注册 的 


息 事 件 


续 多 次 


， 并 且 另 存 了 一 个 文件 messageBoundaryEventNoCancelActivity.bpmn。 


擎 不 会 在 触发 了 消息 之 后 取消 已 注册 的 消息 事件 。 


触 友 ， 直 到 完成 任务 “审核 文件 " 


任务 : 协助 处 理 
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六 从 结束 


execut 
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taskService.createTaskQuery () .taskName ("协助 处 理 ") 


taskService.complete (task2 .getId()) 
// 但 稳重 凡 名 名 入 交 件 : 此 时 有 3 个 注册 六 忆 各 家 知人 ， 协助 处 理 “ 的 事件 
IonQuery.count () ) ， 
ijonQuery.1ist (); 
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cancelActivity="false" 


任务 ; 审核 文件 


执行 步骤 ; 
1、 创 建 任务 实例 
2、 注 册 消 息 边 界 事件 


图 11-17 


BoundaryEventNoCancelActivity.bpmn") 


BoundaryEventNoCancelActivity"); 


.SingleResult () ， 
'xecutionQuery () 


不 触发 事件 直接 完成 任务 


多 次 触发 消息 边 


ion.getId()); 
ion.getId()); 
.count ()); 
tion2.getId()) .singleResult ()，; 
tanceQuery() .finished() .count () ) ， 


界 事件 执行 过 程 


任务 : 协助 处 理 


有 了 单 次 触发 的 基础 ， 现 在 来 理解 代码 清单 11-12 就 比较 容易 了 ， 根 据 图 11-17 的 过 程 进行 模拟 ， 读 者 可 以 用 Junit 运 行 该 单元 测试 ， 观 察 输出 结果 (一 些 输出 语句 由 于 篇 幅 原因 没有 列 出 来 ) 。 
11.3.3 ”信和 号 边界 事件 


言 号 事件 与 消息 事件 的 事件 处 理 机 制 是 类 似 的 。 图 11-18 把 图 11-13 的 消息 边界 事件 更 改 为 信号 边界 事件 。 


从 图 11-18 中 可 以 看 出 ， 添 加 、 编 辑 、 设 置信 号 的 方式 与 消息 事件 类 似 ， 所 以 不 再 做 过 多 的 介绍 ， 读 者 可 以 参考 图 11-13 和 图 11-14。 
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图 11-18 ”包含 信号 边界 事件 的 文档 审批 流程 图 


图 11-18 生 成 的 XML 代码 与 图 11-13 生 成 的 XML 代码 类 似 ， 只 不 过 把 message 换 成 了 signal。 下 面 列 出 了 一 些 关 键 代 码 ， 可 以 与 消息 类 型 的 边界 事件 进行 对 比 。 


<signal idq="S HELP" name="S 协助 处 理 "></signal> 
<process id="signalBoundaryEvent" name="Signal Boundary Event" isExecutable="true"> 
<boundaryEvent id="boundarysignall" name="Signal" attachedToRef="usertaskl" cancelActivity="true"> 
<signalEventDefinition signalRef='"S HELP"/> 
</boundaryEvent> 加 
</process> 


由 于 信号 边界 事件 与 消息 边界 事件 的 处 理 机 制 类 似 ， 所 以 本 节 不 在 用 大 篇 幅 内 容 讲解 ， 读 者 可 以 参考 本 章 源码 的 SignalBoundaryEventTest.java 单 元 测试 类 ， 该 测试 类 中 包含 了 属性 cancelActivity 的 什 
为 true 和 false 两 种 情况 。 


村 a 说明 Java Service 任 务 不 支持 定时 边界 事件 ， 原 因 是 Java Service 任 务 可 能 会 因 运 行 时间 过 长 或 者 Java 类 执行 失败 后 事务 回 滚 导 致 数据 状态 不 一 致 。 如 果 想 要 为 边界 事件 添加 一 个 定时 任务 ， 可 以 在 
实现 类 中 利用 其 他 的 定时 作业 框架 实现 或 者 把 任务 发 送 到 消息 服务 。 


11.4 ”中 | 间 事 件 


根据 11.3 节 中 对 边界 事件 的 理解 我 们 知道 ， 边 界 事件 是 “捕获 型 ”的 ， 它 可 以 监听 其 依附 的 活动 上 的 某 一 种 类 型 的 事件 。 本 节 将 要 介绍 的 中 间 事 件 有 抛 出 型 和 捕获 型 两 种 。 之 所 以 称 之 为 中 间 事 件 是 因 
为 这 类 事件 总 是 在 两 个 输出 流 中 间 存 在 。 图 11-19 展 示 了 包含 一 个 信号 边界 事件 与 信号 中 间 捕 获 事件 的 流程 。 


在 图 11-19 (catchMultipleSignals.bpmn) 中 有 两 个 捕获 类 型 的 信号 事件 ， 左 侧 的 信号 中 间 捕 获 事件 监听 的 信号 名 称 为 “abort” ， 用 户 任务 “附加 边界 用 户 任务 ”附加 的 信号 边界 事件 捕获 的 信号 名 称 
为 “alert”。 从 该 流程 图 中 可 以 看 出 在 启动 流程 之 后 会 向 引擎 注册 两 个 信号 事件 (与 注册 消息 事件 类 似 ) ， 然 后 流程 处 于 等 待 状 态 ， 在 通过 调用 API 或 者 主动 在 流程 中 抛 出 一 个 信号 事件 后 该 流程 对 应 的 信号 
事件 将 被 触发 并 执行 后 续 的 输出 流 。 


EE 
附加 边界 用 户 任务 


图 11-19 包含 信号 中 间 捕 获 事 件 的 流程 图 


为 了 了 解 信号 事件 的 抛 出 与 捕获 ， 利 用 图 11-20 (throwAbortSignal.bpmn) 和 图 11-21 (throwAlertSignal.bpmn) 中 的 两 个 简单 流程 模拟 主动 抛 出 信号 事件 。 
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图 11-21 抛 出 alert 信 号 


图 11-20 中 的 信号 中 间 抛 出 事件 对 应 的 XML 如 下 : 


<intermediateThrowEvent id="signalintermediatethrowevent1" 

name="SignalThrowEvent"> 

<signalEventDefinition signalRef="abort"/> 
</intermediateThrowEvent> 


图 11-21 中 的 信号 中 间 抛 出 事件 对 应 的 XML 如 下 : 


<intermediateThrowEvent id="signalintermediatethrowevent1" 

name="SignalThrowEvent"> 

<signalEventDefinition signalRef="alert"/> 
</intermediateThrowEvent> 


对 应 地 ， 图 11-19 中 的 信号 中 间 抛 出 事件 与 信号 边界 事件 的 XML 如 下 : 


<signal id="alert" name="alert"></signal> 

<signal id="abort" name="abort"></signal> 

<! 一 ”信和 号 中 间 捕 获 事件 --> 

<intermediateCatchEvent id="signalintermediatecatcheventl" name="SignalCatchEvent"> 

<signalEventDefinition signalRef="abort"/> 

</intermediateCatchEvent> 

<! 言 号 边界 事件 --> 

<boundaryEvent id="boundarysignall" name="Signal" 
attachedToRef="usertaskl" cancelActivity="true"> 

<signalEventDefinition signalRef="alert" /> 
</boundaryEvent> 


为 了 将 这 三 个 流程 联合 起 来 了 解 抛 出 型 与 捕获 型 事件 如 何 工作 ， 我 们 通过 一 个 单元 测试 来 模拟 流程 的 执行 过 程 ， 见 代码 清单 11-13。 


代码 清单 11-13 ”信号 中 间 ( 抛 出 、 捕 获 ) 事件 与 边界 事件 测试 


public class SignalIintermediateEventTest extends PluggableActivitiTestCase { 

QDeployment (resources = { "chapterll/intermediateEvent/signal/catchMultipleSignals.bpmn", 
"chapterll/intermediateEvent/signal/throwAlertSignal .bpmn", 
"chapterll/intermediateEvent/signal/throwAbortSignal.bpmn" }) 

public void testSignalIntermediateEvent () throws Exception { 

runtimeService.startProcessInstanceByKey ("catchSignal"); // 启动 图 11-19 所 示 的 流程 
// 注册 了 两 个 信号 事件 : alert、abort 
assertEquals (2, createEventSubscriptionQuery() .count ()); 
assertEquals (1, runtimeService.createProcessInstanceQuery () . 0 
runtimeService.startProcessIinstanceByKey ("throwAbort i 


// 启动 了 图 11-20 所 示 的 流程 后 抛 出 了 abort 信 号， 站 从 移 陈 了 注册 的 信 号 事件 
assertEquals (1, createEventSubscriptionQuery() .count ()); 
assertEquals (1, runtimeService.createProcessInstanceQuery() .count ()); 

Task taskAfterAbort = taskService.createTaskQuery () 
.taskName ("被 信号 中 间 抛 出 事件 触发 ") .singleResult () ; 


// 图 11-19 中 的 中 间 信号 捕获 事件 捕获 到 abort 信 号 后 创建 了 用 户 任务 
assertNotNull (taskAfterAbort); 
taskService.complete (taskAfterAbort .getId()); 

runtimeService.startProcessinstanceByKey ("throwAlert"); #2 

// 启动 了 图 11-21 的 流程 后 抛 出 了 alert 信 号 ， 触 发 了 "附加 边界 用 户 任务 “上 的 
// 信号 边界 事件 ， 该 任务 随即 被 取消 并 创建 任务 "通过 信和 号 边界 事件 触发 

Task taskAfterAlert = taskService.createTaskQuery () 
.taskName ("通过 信号 边界 事件 触发 ") .singleResult (); 


assertNotNull (taskAfterAlert); 

taskService.complete (taskAfterAlert .getId()); 

// 注册 的 事件 都 已 被 触发 ， 此 时 再 次 统计 结果 为 0 
assertEquals (0, createEventSubscriptionQuery() .count () ) ; 
assertEquals (0，LuntimeService .createProcessInstanceQuery () .count () ) ， 


通过 代码 清单 11-13 的 执行 过 程 分 析 了 解 了 如 何 抛 出 、 捕 获 信号 事件 。 除 了 可 以 用 信号 中 间 抛 出 事件 触发 信号 捕获 事件 之 外 ， 还 可 以 用 手动 方式 调用 引 警 API 触发。 代码 清 单 11-13 的 #1 与 #2 处 可 以 用 下 
面 的 两 行 代码 替代 ， 读 者 可 以 自行 实践 。 


Received ("alert");} 
Received ("abort"); 


runtimeService.signalEven 
runtimeService.signalEven 


GE 


11.5 本章 小 结 


事件 是 Activiti 中 比较 重要 的 一 块 内 容 ， 本 章 先后 介绍 了 启动 事件 、 结 束 事件 、 边 界 事件 、 中 间 事 件 这 4 类 事件 。 每 一 大 类 又 根据 不 同 功 能 进行 了 进一步 划分 ， 读 者 可 以 结合 图 标 、 测 试用 例 来 理解 ， 根 
据 业 务 需求 的 不 同 选择 不 同 的 事件 类 型 以 及 触发 事件 的 方式 。 


第 12 章 ”用 户 任 务 与 附件 


在 一 般 流程 中 大 部 分 活动 都 是 任务 处 理 ， 例 如 用 户 任务 、Java service 任务 、Webservice 任 务 、 业 务 规则 任务 或 者 邮件 任务 等 。 在 这 几 类 任务 中 ， 除 了 用 户 任务 需要 人 参与 处 理 外 其 他 任务 都 由 引擎 
动 处 理 。 


本 章 以 用 户 任务 为 主线 ， 介 绍 和 用 户 任务 有 关 的 操作 、 原 理 ， 包 括 更 改 用 户 任务 的 属性 ， 添 加 或 者 删除 任务 的 候选 人 (组 ) 、 参 与 人 ， 如 何不 通过 流程 创建 任务 ， 如 何 实现 任务 委派 ， 以 及 和 任务 相关 
附件 。 


图 12-1 展 示 的 是 Activiti Explorer 的 任务 办 理 界 面 ， 用 箭头 和 文字 对 不 同 的 区 域 进行 了 说 明 。 本 章 的 内 容 将 围绕 图 12-1 的 每 一 个 区 域 的 功能 点 进行 一 一 讲解 。 
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当前 任务 的 韦 任 务 
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Fill in the form below and complete the task: 


Do you approve this vacalion” |Approve 


Motivation 


op lt Ls EE to ri 


图 12-1 Activiti Exploret 任 务 办 理 界 面 


12.1 用 户 任务 


首先 要 对 现 有 的 任务 列表 (如 图 12-2 所 示 ) 进行 改进 ， 目 前 的 问题 是 在 没有 签收 任务 时 不 能 查看 任务 表单 ， 需 要 改进 的 内 容 有 下 面 两 项 : 
` 在 不 签收 的 情况 下 可 以 查看 表单 。 


“ 查看 (依赖 第 一 项 改进 ) 表单 时 可 以 签收 任务 。 


任务 ID ”任务 名 称 流程 实例 ID ” 流程 定 义 ID 任务 创建 时 间 


22 领导 审批 ”11 purchase-subprocess:1:10 Thu Mar 14 19:52:11 CST 2013 


图 12-2” 待 办 任务 列表 
12.1.1 ”改进 任务 列表 
首先 改进 的 是 待 办 任务 列表 ， 在 不 签收 任务 的 情况 下 可 以 查看 任务 表单 ， 单 击 图 12-3 中 添加 的 “查看 ”按钮 可 以 打开 图 12-4 的 任务 表单 界面 。 图 12-3 的 “查看 ”按钮 和 图 12-4 的 “签收 ”按钮 通过 任务 


的 办 理 人 (assignee) 属性 是 否 为 空 作 为 条 件 控制 按钮 是 否 显示 。 


任务 ID | 任务 名 称 ”流程 实例 ID ”流程 定 久 ID 任务 创建 时 间 


22 领导 审批 11 Purchase-subprocess:1:10 Thu Mar 14 19:52:11 CST 2013 


图 12-3 ”改进 后 的 任务 列表 


Activiti Explorer 会 首 页 加 请 假 ( 首 通 表单 ) ~ | 三 任务 列表 | 二 管理 ~ 


任务 办 理 一 [领导 审批 ]， 流 程 定义 ID: [purchase-subprocess:1:10] 


Karrmit 


2013-03-01 


根据 伍 务 是 特 拥 有 办理 人 
决定 显示 “签收 ” 
渤 是 “完成 任务 ” 按钮 


er 


1. daftwfwe kermt 1! 领导 审批 ) 12013 8:06:36 PM 


| 二 保存 意见 国 | 


图 12-4 任务 表单 界面 


图 12-4 任 务 表 单 中 的 签收 按钮 控制 显示 与 否 的 逻辑 如 下 (task-form.jsp) : 


<c:if test="${not empty task.assignee}"> 
<button type="submit"> 完 成 任务 </button> 


/Gif 
<c:if test="${empty task.assignee}"> 
<a href="${ctx }/chapter6/task/claim/$ {task.id} 
?nextDo=handle"> 签 收 </a> 


</c:if> 


“签收 ”按钮 传递 了 一 个 参数 nextDo， 表 示 签 收 之 后 的 动作 ， 前 面 章节 的 例子 中 签收 按钮 只 在 任务 列表 显示 ， 单 击 了 之 后 签收 任务 便 回 到 任务 列表 。 如 果 单 击 任务 表单 中 的 “签收 ”按钮 ， 不 仅 需 要 签 
收 任务 还 需要 重新 打开 任务 表单 ， 以 便 显示 “完成 任务 ”按钮 ， 单 击 此 按钮 可 以 提交 任务 。 


后 台 任 务 签收 控制 器 (TaskControllerjava#claim) 也 需要 修改 以 支持 nextDo 参 数 的 不 同 取 值 。 下 面 的 代码 展示 了 针对 nextDo 参 数 的 值 为 “handle” 时 的 处 理 : 


if (StringUtils.equals (nextDo, "handle")) { 

return "redirect:/chapter6/task/getform/" + taskId; 
} else { 

return TASK_LIST; // 在 默认 情况 下 签收 之 后 回 到 任务 列表 
} 


稍 加 改造 后 的 任务 列表 与 任务 表单 就 可 以 满足 我 们 预期 的 两 个 功能 ， 当 单 击 了 图 12-4 的 “签收 ”按钮 之 后 ，“ 完 成 任务 ”按钮 就 显示 出 来 了 ， 如 图 12-5 所 示 。 


图 12-5 在 任务 表单 中 单 击 “ 签 收 ” 按 钮 后 显示 “完成 任务 ”按钮 


12.1.2 ”改进 任务 表单 


在 图 12-1 的 顶部 除了 显示 任务 名 称 之 外 还 有 下 面 几 个 属性 : 

* 任务 到 期 日 (No due date) 。 设 置 了 这 个 属性 之 后 可 以 提前 一 段 时 间 向 用 户 发 送 通知 ， 例 如 通过 邮件 、 短 信 等 方式 。 

“ 任务 优先 级 (Medium Priority) 。 任 务 的 优先 级 可 以 从 1~100， 一 般 约 定 0 表示 低 ，50 表 示 中 ，100 表 示 高 ; 当然 分 级 的 粒度 还 可 以 更 细 ， 例 如， 对 于 引擎 ， 建 议 像 下 面 这 样 分 级 : 
* [Ohttp://www.hzcourse.com/resource/rteadBook?path=/openresources/teach_ebook/uncompressed/15030/OEBPS/Text/..19] 表 示 最 低级 
* [20http://www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15030/OEBPS/Text/..39] 表 示 低 级 
* [40http://www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncomptressed/15030/OEBPS/Text/..59] 表 示 一 般 
* [60http://www.hzcourse.com/resource/rteadBook?path=/openresources/teach_ebook/uncomptressed/15030/OEBPS/Text/..79] 表 示 高 级 
* [80http://www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncomptressed/15030/OEBPS/Text/..100] 表 示 最 高 级 
任务 创建 时 间 。 


添加 了 这 几 个 属性 后 效果 如 图 12-6 所 示 ， 从 图 中 可 以 看 出 在 任务 名 称 下 方 添加 了 任务 到 期 日 (dueDate) 、 优 先 级 (priority) 、 创 建 日 期 (createTime) 。 查 看 引擎 的 API| 文 档 可 以 看 到 
org.activiti.enginee.Task 的 getter 方 法 ， 以 此 类 推 可 以 在 任务 表单 中 显示 更 多 的 属性 。 


任务 办 理 一 [领导 审批 ]， 流 程 定义 ID: [purchase-subprocess:1:10] 


菌 到 期 日 ， 无 到 期 日 ” 各 优先 级 ， 中 。 获 创建 日 期 : 2013-03-14 07:52:11 


图 12-6 在 任务 表单 中 添加 了 任务 属性 


下 面 的 代码 列 出 了 显示 任务 属性 的 HTML 代 码 ， 其 中 利用 <c:if/ > 标签 进行 了 条 件 判断 : 


<span><i class="icon-calendar"></i> 到 期 日 
<c:if test="${empty task. rel '> 无 到 期 日 </c:if 
<c:if test="${not empty task.dueDate}"> 
${task. de ale ee > 


Vv 


</span> 
<span><i class="icon-flag"></i> 优 先 级 : 
<c:if test="${empty task.priority}"> 无 到 期 日 </c:if> 
<c:if test="${not empty task. i 


<crif test="S{task, priority = == 0}"> 低 </c:if> 
<c:if test="${task.priority == 50}"> 中 </c:if> 
<c:if test="${task.priority == 100}"> 局 </c:if> 


< Grif 

</span> 

<span><i class="icon-calendar"></i> 创 建 日 期 : 
<fmt:formatDate value="${task.createTime}" 

pattern="yyyy-MM-dd hh:mm:ss"/> 


</span> 


细心 的 读者 可 能 会 发 现 ， 单 击 图 12-1 的 任务 属性 后 可 以 直接 更 改 任务 属性 的 值 ， 如 图 12-7 所 示 。 在 任务 属性 的 值 更 改 了 之 后 可 以 利用 Ajax () 向 后 台 发 送 请 求 ， 从 而 调用 引擎 API 更 改 任务 属性 。 


Handle vacation request 
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图 12-7 单 击 任 务 属 性 可 以 更 改 任务 属 性 的 值 
为 了 学 习 如 何 调用 引 警 的 API 更 改 任务 属性 ， 对 图 12-6 中 的 任务 属性 进行 再 次 改造 ， 利 用 html 组 件 的 change (在 组 件 的 值 更 改 后 可 以 回调 一 个 指定 的 函数 ) 事件 监听 实现 异步 发 送 更 改 属性 请 求 。 


经 过 改造 后 再 次 单 击 任务 属性 时 就 会 看 到 如 图 12-8 所 示 的 任务 属性 编辑 功能 ， 在 选择 了 日 期 后 ， 失 去 输入 框 的 焦点 即 可 自动 发 送 异步 的 POST 请 求 ， 后 台 响 应 成 功 后 将 日 期 更 改 为 选择 的 日 期 。 


王 务 办 理 一 [领导 


获 到 期 日 : | <013-03-28 阳 优先 级 : 高 


March 2013 
sy Mo Tu We Th Fr Sa 


24 25 26 27 28 1 2 


图 12-8 单 击 任务 属性 可 以 进行 更 改 


由 于 动态 任务 属性 使 用 的 jQuery 不 在 本 书 讨论 范围 之 内 ， 因 此 这 里 对 实现 细节 不 做 讨论 ， 读 者 可 以 自行 查看 源码 了 解 实现 过 程 (chapter12-task-attachment 中 的 task-form.js 文 件 ) 。 处 理 请 求 的 
Java 代 码 才 是 本 节 的 重点 内 容 ， 根 据 请 求 参数 更 改 任务 属性 的 代码 如 代码 清单 12-1 所 示 。 


代码 清单 12-1 更 改 任务 属性 的 控制 器 方法 


RequestMapping ("task/property/ {taskId}") 

ResponseBody 

public String changeTaskProperty (GPathVariable ("taskId") String taskId, 
RequestParam("propertyName") String propertyName, 
RequestParam("value") String value) { 

// 根据 任务 ID 查 询 任务 对 象 

Task task = taskService.createTaskQuery() .taskId (taskId) .singleResult () ， 
if (StringUtils.equals (propertyName, "dueDate")) { // 更 改 到 期 日 

SimpleDateFormat sdf = new SimpleDateFormat ("yyyy-MM-dd"); 

Date parse = sdf.parse (value); 
task.setDueDate (parse); // 设置 到 期 日 
taskService.saveTask (task); ”// 更 新 任务 属性 
} else if (StringUtils.equals (propertyName, "priority")) { // 更 改 任 务 优先 级 
task.setPriority (Integer.parseInt (value)); // 设置 优先 级 属 怕 
taskService.saveTask (task); 
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return "success"™;} 


12.1.3 ”任务 相关 人 员 


在 图 12-1 中 的 “People” 一 栏 中 可 以 看 到 任务 的 拥有 人 (owner) 、 任 务 办 理 人 (assignee) ， 以 及 其 他 类 别 的 人 员 。 下 面 分 别 说 明 用 户 任务 相关 的 几 类 人 员 的 作用 。 
` 拥有 人 : 在 流程 处 理 过 程 中 产生 的 用 户 任务 ， 其 拥有 人 属性 为 空 ， 可 以 通过 调用 API 方 式 更 改 用 户 任务 的 拥有 人 


:办理 人 : 从 前 面 章节 介绍 的 任务 办 理 内 容 中 已 经 有 所 了 解 ， 如 果 将 一 个 任务 直接 分 配给 某 一 个 用 户 ， 则 这 个 用 户 就 是 任务 的 办 理 人 ; 如 果 用 户 包含 在 候选 人 列表 中 或 属于 候选 组 中 ， 并 且 签 收 
(claim) 了 该 任务 ， 此 时 该 用 户 就 是 该 任务 的 办 理 人 。 除 了 这 两 种 方式 还 可 以 像 更 改 任务 到 期 日 一 样 更 改 任务 的 办 理 人 属性 


" 参与 人 : 可 以 为 用 户 任务 添加 不 同类 型 (可 以 是 任意 类 型 ) 的 人 员 参 与 该 任务 办 理 ， 例 如 添加 一 个 用 户 参 与 该 任务 的 贡献 者 (根据 任务 内 容 给 出 办 理 意见 ， 可 以 将 意见 以 批注 的 方式 分 享 给 参与 人 ) 
本 小 节 把 这 三 类 人 员 分 别 添加 到 任务 表单 中 ， 以 了 解 如 何 更 改 、 添 加 入 员 及 其 用 途 。 


设置 任务 的 拥有 人 、 办 理 人 的 方式 与 12.1.2 节 中 设置 任务 到 期 日 的 方式 类 似 ， 因 为 拥有 人 、 办 理 人 都 是 任务 的 一 个 属性 ， 更 新 属性 值 后 保存 任务 即 可 ; 参与 人 不 能 简单 地 以 设置 任务 属性 的 方式 设置 ， 
因为 参与 人 是 一 个 列表 而 不 是 一 个 属性 ( 即 数据 表现 形式 是 一 个 列表 ) ， 为 任务 添加 参与 人 实际 上 是 向 表 (ACT_RU_IDENTITYLINK) 中 插入 一 条 数据 。 


使 用 相同 的 方式 设置 任务 拥有 人 、 办 理 人 ， 在 任务 表单 JavaScript 与 控制 器 中 添加 类 似 的 处 理 代码 即 可 很 容易 地 完成 这 两 个 属性 的 设置 功能 ,图 12-9 展 示 了 最 终 效果 。 


控制 器 在 代码 清单 12-1 的 基础 上 添加 了 对 于 拥有 人 与 办 理 人 的 支持 ， 代 码 片段 如 下 ，Javascript 也 做 了 对 应 的 改进 与 支持 。 


if (StringUtils.equals (propertyName, "owner")) { 
// 更 改 拥 有 人 
task.setOwner (value); 
taskService.saveTask (task); 
} else if (StringUtils.equals (propertyName, "assignee")) { 
// 更 改 办 理 人 
task.setAssignee (value); 
taskService.saveTask (task); 


- 务 办 理 一 [领导 审批 ] ， 流 程 定义 ID: [purchase-calla 


菌 到 期 日 ， 无 到 期 日 了 优先 级 ; 高 菌 创建 日 期 2014-11-20 12:09:16 


务 人 员 

拥有 人 :|vAmy Zhang 

Andy Zhao 

Bill Zheng 

参与 人 | EricU - 候选 组 ” 美 删除 
匡 选 [人 | 组 | 四 EY 
Jenny Luo 


星 办 理 人 : kermit 星 任 务 委派 : 无 


图 12-9 添加 了 任务 人 员 设置 功能 


对 于 参与 人 ， 用 现实 的 场景 可 能 更 容易 理解 ， 例 如 一 个 项 目 聘 请 了 业务 顾问 ， 当 讨论 某 一 个 需求 时 ， 可 以 邀请 顾问 参与 进来 ， 顾 问 只 是 一 种 角色 或 者 职责 ， 因 此 可 以 根据 具体 的 制度 (公司 岗位 的 划 
分 ) 预 设 几 种 类 别 ， 通 过 添加 几 个 预 设 的 类 别 作为 任务 的 候选 类 型 ， 如 贡献 人 、 项 目 经 理 、 总 经 理 、 业 务 顾 问 、 技 术 顾问 、 执 行人 。 


图 12-10 展 示 了 在 Activiti Explorer 中 添加 参与 人 的 界面 ， 被 邀请 的 用 户 将 有 权限 查看 该 任务 ， 可 以 对 任务 内 容 做 出 响应 (通过 添加 意见 的 方式 互动 ) 。 图 12-11 展 示 的 是 改造 后 的 任务 人 员 区 域 ， 
在 “参与 人 ”部 分 可 以 看 到 已 经 被 邀请 的 三 个 参与 人 ， 单 击 后 面 的 “删除 ”链接 可 以 删除 一 个 参与 人 。 添 加 参与 人 后 单 击 “ 邀 请 ”按钮 弹出 如 图 12-12 所 示 的 对 话 框 。 


Involve people 


| Search people .. 


Contributor 


图 12-10 ”在 Activiti Explotet 中 添加 参与 人 


任务 人 员 
里 拥有 人 : henry 星 办 理 人 :; kermit 


参与 人 ， amy -- 贡献 人 其 删除 
* henry -- 总 经 理 其 删 队 
* jaenny -- 技术 顾问 其 删除 


图 12-11 改造 后 的 任务 人 员 区 域 


单 击 可 添加 天 行 


Amy zhang 


Bil Zheng 


图 12-12 ”邀请 参与 人 对 话 框 
单 击 了 图 12-12 的 “确定 邀请 ”按钮 后 通过 Ajax 方式 发 送 请 求 至 后 台 控制 器 ， 成 功 后 刷新 页 面 即 可 看 到 图 12-11 所 示 的 参与 人 列表 。 
由 于 参与 人 页 面 操作 的 相关 Javascript 代 码 比较 多 且 不 属于 本 书 讨论 范围 ， 故 不 作 过 多 的 解释 ， 重 点 是 引擎 提供 的 API 如 何 使 用 。 


代码 清单 12-2 列 出 了 添加 参与 人 的 相关 代码 ， 方 法 addParticipants() 接 收 数组 形式 的 用 户 I1D 和 类 型 1D， 分 别 对 应 图 12-12 中 的 两 个 下 拉 框 选择 的 值 ， 然 后 循环 多 次 调用 引擎 能 
TaskService#addUserldentityLink() 添 加 参与 人 。 对 应 地 ， 也 可 以 调用 deleteUserldentityLink() 方 法 删除 一 个 参与 人 。 


代码 清单 12-2 ”为 任务 添加 参与 人 的 控制 器 代码 


QRequestMapping ("task/participant/add/ {taskId}") 

QResponseBody 

public String addParticipants (GPathVariable ("task1Id") String taskId， 
QRequestParam("userId[]") String[] userIds, QRequestParam("typel[]") 

String[] types) { 

String currentUserId = UserUtil.getUserFromSession (request.getSession()) .getId(); 
identityService.setAuthenticatedUserId (currentUserId); // 记录 当前 操作 人 


for (int i = 0; i < userlds.length; i++) { 
taskService.addUserIdentityLink (taskId, userlds[i], types[i]); 


} 


return "success"™; 


} 


读 取 参与 人 列表 也 比较 简单 ， 在 读 取 任务 表单 的 控制 器 方法 (代码 清单 6-26) 中 添加 下 面 的 代码 ， 读 取 到 一 个 List 集 合 ， 将 该 集合 添加 到 ModelAndView 对 象 中 ， 如 此 即 可 在 JSP 页 面 中 循环 输出 参与 


List<IdentityLink> identityLinksForTask = 
taskService.getIidentityLinksForTask (taskId); 
mav.addobject ("links", identityLinksForTask); 


通过 调用 ldentityLink 对 象 的 getter 方 法 可 以 获取 和 任务 、 参 与 人 有 关 的 数据 ， 其 API 如 图 12-13 所 示 。 在 图 12-11 中 显示 参与 人 的 代码 可 以 参见 task-form.jsp 文 件 。 


Method and Description 


getGroupIdl() 

If the identity link Involves a group, then this will be a non-null id of a group. 
getTaskId!() 

The id of the task associated with this identity link, 

getIypel) 

Returns the type of link. 

getUserIdl() 

If the identity link Involves a user, then this will be a non-null id of a user. 


图 12-13 ”IdentityLink 对 象 的 API 
单 击 图 12-11 中 的 “删除 ”链接 后 即 可 删除 一 个 参与 人 ， 也 就 是 从 ACT_RU_IDENTITYLINK 表 中 删除 一 条 数据 ， 代 码 清单 12-3 列 出 了 删除 参与 人 的 代码 。 


代码 清单 12-3 ”删除 参与 人 的 控制 器 代码 


RequestMapping ("task/participant/delete/ {taskId}") 

ResponseBody 

public String deleteParticipant (GPathVariable ("taskId") 2 taskIgd, 
QRequestParam(value = "userId") String userId j 户 ID 
QRequestParam("type") String type) { // 多 天 
taskService.deleteUserIidentityLink (taskId, userId, type); 
return "success"; 


} 


人 


~ 一 


12.14 反 签 收 任务 


反 签 收 是 相对 于 签收 动作 来 说 的 ， 顾 名 思 义 ， 可 以 把 已 经 签收 的 任务 的 办 理 人 置 空 ， 这 样 任务 又 还 原 到 未 签收 状态 ， 此 功能 对 于 日 常 使 用 中 误 签 收 的 情况 非常 有 用 。 


反 签 收 任务 的 AP 与 签收 任务 的 相同 ， 唯 一 不 同 的 是 在 签收 任务 时 需要 传递 任务 ID 和 用 户 I1D， 而 反 签 收 只 需要 传递 任务 ID， 用 户 ID 参 数 以 “null” 代 蔡 即 可 。 下 面 的 代码 展示 了 两 者 的 不 同 : 


taskService.claim(taskId，userId); // 签收 ，userIgd 不 能 为 空 
taskService.claim(taskId, null); // 反 签收 ， 第 二 个 参数 为 空 


把 反 签收 功能 加 入 到 任务 列表 中 ， 根 据 任务 的 办 理 人 是 否 为 空 判断 是 否 显 示 反 签收 按钮 ， 图 12-14 展 示 的 是 已 签收 的 任务 ， 图 12-15 展 示 的 是 单 击 了 “ 反 签 收 ” 按 钮 后 的 任务 列表 。 


流 程 实例 ID 流程 证 光 ID 尾 田 创建 时 间 办 理 人 操作 
1 Purc J = Dprocess:1 :10 Thy Mar 12 19:52'11 GST a013 民生 Fr 站 让 用 办 理 转 反 繁 收 


图 12-14 ”签收 任务 后 的 任务 列表 


任 奋 已 反 签收 


尾 务 ID 任务 名 称 | 谅 程 实例 ID ”流程 定义 ID 尾 务 创建 时 间 
22 领导 审批 | 11 purchase-subprocess:1:10 Thu Mar 14 19:52:11 CST 2013 


图 12-15 单 击 “ 反 签 收 ” 按 钮 后 的 任务 列表 


在 执行 反 签收 时 有 一 点 要 特别 注意 ， 如 果 用 户 任务 没有 相关 候选 人 与 候选 组 ， 执 行 反 签收 动作 会 导致 任务 无 人 认领 (可 以 理解 为 游离 状态 ) ， 所 以 在 反 签 收 时 要 判断 该 任务 是 否 满足 反 签收 条 件 。 可 以 
通过 查询 任务 是 否 有 候选 人 或 者 候选 组 的 方式 验证 ， 如 代码 清单 12-4 所 示 。 


代码 清单 12-4” 反 签收 动作 附带 条 件 检验 


// 肥 签 收 条 件 过滤 
st<] ee links = 0 2 [dentityLinksForTask (asSkId) 
for (Ident ink identit :in 

#4 若 果 个 竹 务 有 相关 的 很 北大" 扎 沈 组 就 守 以 肥 答 收 


~ 一 


if (StringUtils.equals (IdentityLinkType.CANDIDATE, identityLink.getType())) { 
taskService.claim(taskId, null); 
break; 
} 
} 


代码 清单 12-4 首 先 查 询 和 任务 相关 的 人 员 ， 循 环 判断 ldentityLink 对 象 的 候选 类 型 是 否 为 “candidate”， 如 果 不 是 “candidate”， 则 不 执行 反 签收 ， 在 一 定 程度 上 可 以 解决 任务 反 签收 后 导致 无 人 认 
领 的 问题 。 


12.1.5 “候选 人 与 候选 组 


在 12.1.3 节 中 了 解 了 通过 TaskService#addUserldentityLink(taskld，userld，identityLink-Type) 方 法 可 以 添加 一 个 参与 人 ， 其 中 第 三 个 参数 identityLinkType 支 持 多 种 参与 人 关系 类 型 。 引 人 苟 对 于 每 
一 种 参与 人 关系 类 型 都 有 不 同 的 处 理 方式 ， 具 体 如 下 : 


:assignee， 任 务 的 办 理 人 ， 不 会 向 表 ACT_RU_IDENTITYLINK 中 播 入 数据 ， 和 Task#setAssignee0 的 功能 一 样 〈( 实 际 就 是 调用 了 这 个 方法 后 更 新 任务 ) 。 
. ownef， 任 务 的 拥有 人 ， 与 assignee 一 样 ， 不 插入 数据 仅仅 调用 Task#setOwnetr0 后 更 新 任务 。 

“ candidate， 表 示 任 务 的 候选 (人 或 组 ) ， 根 据 表 中 的 两 个 字段 (USER_ID_、GROUP_ID_) 是 否 为 空 来 判断 是 候选 人 还 是 候选 组 。 

“starter，Activiti 5.12 版 本 新 添加 的 类 型 ， 如 果 在 启动 流程 时 设置 了 认证 用 户 ， 则 会 向 表 ACT_RU_IDENTITYLINK 中 插入 一 条 数据 表示 流程 启动 人 。 


participant，Activiti 5.12 版 本 新 添加 的 类 型 ， 在 添加 候选 人 、 候 选 组 或 者 非 引 擎 支持 的 关系 类 型 时 引擎 会 以 流程 实例 ID 作 为 标志 ( 仅 设置 PROC_INST_ID_ 字 段 值 不 设置 TASK_ID_ 字 段 值 ) 插 入 数据 到 
表 ACT_RU_IDENTITYLINK 中 ， 方 便 根 据 流程 实例 查询 参与 人 数据 。 


6 注意 “候选 人 与 参与 人 是 有 区 别 的 : 候选 人 有 权限 签收 任务 ， 参 与 人 一 般 没有 权限 签收 任务 ， 仅 仅 提供 参考 意见 。 
图 12-16 比 图 12-11 多 出 了 一 个 “添加 候选 [人 | 组 ] ”按钮 ， 单 击 此 按钮 弹出 图 12-17 所 示 的 “添加 候选 [人 了 组 ]” 对 话 框 ， 可 以 根据 “候选 类 型 ”选择 候选 人 或 候选 组 。 


图 12-17 中 的 “候选 类 型 ”有 两 类 (user: 候选 人 ，group: 候选 组 ) ， 在 更 改 了 候选 类 型 后 ， 在 “人 /组 ”显示 对 应 的 下 拉 框 (通过 JavaScript 控 制 自动 隐藏 对 方 ) ， 单 击 按钮 “确定 添加 ”将 收集 数 
据 发 送 给 代码 清单 12-5 中 的 控制 器 方法 。 


霄 到 期 日 2013-03-29 


任 沙 人 员 


生 拥 有 人 : amy 


参与 人 人 ”amy -- 贡献 人 (参与 人 ) 
展 选 [ 八 殴 ] henry -- 总 经 理 (参与 人 ) 


图 12-16 添加 了 候选 [人 | 组 ] 按 钮 及 列表 


添加 候选 [人 | 组 ] 


候选 类 型 


图 12-17 添加 候选 [人 | 组 | 对 话 框 


代码 清单 12-5 添加 候选 人 、 候 选 组 的 控制 器 代码 


QRequestMapping ("task/candidate/adgd/ {taskId}") 
QResponseBody 
public String addCandidates (@PathVariable ("taskIid") String taskId， 
QRequestParam ("userOrGroupIds[]") String[] userOrGroupIds， // 用 户 ID 或 组 ID 
GReduest LParam!l 'type[]") String[] types) { // 类 型 (user、group) 
for (int i = 0; i < userOrGrouplds.length; i++) { 
String type = types[il; 
if (StringUtils.equals ("user", type)) { // 不 同 的 类 型 调用 不 同 的 API 方 法 
taskService.addCandidateUser (taskId, userOrGrouplds[i]); 
} else if (StringUtils.equals ("group", type)) { 
taskService.addCandidateGroup (taskId, userOrGroupIds[i]); 
} 
} 
return "success"™; 
} 
需要 特别 说 明 ， 通 过 TaskService#addCandidateUser、TaskService#addCandidateGroup 添 加 的 候选 类 型 均 为 “candidate”， 所 以 在 任务 表单 中 显示 候选 人 与 候选 组 时 只 可 以 一 并 处 理 ， 见 如 
下 代码 : 
<c:when test="${link.type == 'candidate'}"> 
<c:set var="type" 
value=" 候 选 ${not empty link.userId ? "人 '， : ' 组 '}" /> 
</c:when> 


可 以 动态 添加 候选 人 、 候 选 组 ， 对 应 地 也 可 以 删除 已 添加 的 候选 人 、 候 选 组 ， 代 码 清单 12-3 已 经 展示 了 如 何 删除 一 个 参与 人 。 添 加 参与 人 与 添加 参与 组 在 引 警 内 部 实现 其 实 调用 的 是 同一 个 API， 唯 一 
不 同 的 是 参与 的 类 型 ， 所 以 删除 参与 人 与 删除 参与 的 方法 组 也 类 似 。 但 是 候选 组 与 候选 人 又 有 所 不 同 ， 因 此 需要 根据 不 同 的 情况 加 以 判断 ， 然 后 再 调用 对 应 的 删除 方法 。 


-大 十 / 


在 代码 清单 12-3 的 基础 上 添加 了 支持 删除 候选 人 、 候 选 组 的 功能 ， 判 断 的 依据 是 当 参 数 groupld 不 为 空 时 调用 删除 候选 组 方法 ， 其 他 的 情况 和 删除 参与 人 的 方法 相同 ， 具 体 见 代码 清单 12-6 所 示 。 


代码 清单 12-6 支持 删除 参与 人 、 候 选 人 、 候 选 组 


QRequestMapping ("task/participant/delete/ {taskId}") 

@QResponseBody 

public String deletePart noipant (CPTathVarialdle, 'taskId") String taskIg, 
QRequestParam(value = "userId", required = false) String userIg, 


QRequestParam(value = "groupld", required = false) String groupId， 
QRequestParam("type") String type) { 

Ef (StringUtils.isNotBlank (groupId)) { 
taskService.deleteCangdidateGroup (taskId，groupId); // 对 于 候选 组 特殊 处 理 
} else { 
taskService.deleteUserIidentityLink (taskId, userId, type); 


ais 


} 


return "success"™; 


} 


12.1.6 ”改进 任务 查询 


利用 前 面 几 个 小 节 介绍 了 如 何 动态 添加 参与 人 、 候 选 人 、 候 选 组 ， 其 目的 只 有 一 个 一 一 让 更 多 的 人 参与 任务 办 理 。 现 在 将 话题 回归 到 任务 列表 ， 可 能 有 的 读者 在 添加 了 参与 人 之 后 就 退出 参与 人 登录 系 


统 ， 可 惜 任务 列表 中 没有 任务 数据 ， 但 是 在 动态 添加 候选 人 与 候选 组 后 可 以 查询 到 相关 任务 ， 这 是 为 什么 呢 ? 在 12.1.3 节 中 实现 的 添加 参与 人 功能 可 以 从 一 个 列表 中 选择 自 定义 的 参与 人 类 型 (表示 岗 
位 ) ， 所 以 原本 的 任务 查询 功能 仪 能 查询 到 已 签收 的 或 者 在 候选 人 、 候 选 组 范围 内 的 任务 。 


代码 清单 6-10 中 查询 任务 列表 为 了 兼顾 已 签收 和 未 签收 的 任务 ， 查 询 两 次 把 结果 合并 成 一 个 集合 传递 给 显示 层 ， 这 里 为 了 解决 不 能 查询 参与 人 的 问题 要 对 代码 清单 6-10 的 代码 做 一 些小 改动 。 
把 原来 根据 候选 人 查询 任务 的 taskCandidateUser() 改 为 tasklnvolvedUser( 即 可 ， 最 终 查 询 任务 的 代码 如 代码 清单 12-7 所 示 。 


代码 清单 12-7 最 终 查 询 任 务 


// 读 取 直接 分 配给 当前 人 或 者 已 经 签收 的 任务 


List<Task> doingTasks = taskService.createTaskQuery () 


.taskAssignee (user.get1Id()) .list(); 
// 受 邀 任务 
List<Task> involvedTasks = taskService.createTaskQuery () 
askInvolvedUser (user.get1Id()).1list(); 


// 合并 两 种 任务 
List<Task> allTasks = new ArrayList<Task> (); 
allTasks.adgdAll (doingTasks); 

allTasks.addAll (involvedTasks); 


从 图 12-16 中 可 以 看 出 用 户 “henry” 不 是 任务 的 办 理 人 也 不 是 候选 人 ， 更 改 了 查询 方式 之 后 再 次 查看 任务 列表 可 以 看 到 该 任务 ， 如 图 12-18 所 示 。 


Activitl Explorer 表 首 页 。。 器 请 假 ‘普通 表单 ) ~ ” 路 任务 列表 中 管理 ~ 星 Henry Yaryhanry~ 


任务 ID ”任务 名 称 ”流程 实例 ID ”流程 定义 ID 任务 创建 时 间 办 理 人 操作 
22 领导 审批 11 purchase-subprocess.1:10 Thu Mar 14 19:52:11 CST 2019 各 查 看 二 每 收 


图 12-18 用户 henty 的 任务 列表 
tasklnvolvedUser( 与 taskCandidateUser() 的 区 别 就 在 于 前 者 包含 了 参与 人 人、 候选 人 ， 以 及 属于 某 个 候选 组 的 人 ， 而 后 者 只 在 候选 人 、 候 选 组 范围 内 查询 。 


@i 用 户 任务 相关 的 参与 人 一 般 不 能 签收 任务 ， 所 以 可 以 在 签收 时 检查 一 下 当前 人 是 否 在 候选 人 人、 候选 组 范围 之 内 ， 否 则 不 执行 签收 动作 。 


12.2 ” 子 侍 务 


在 办 理 任务 时 可 能 会 遇 到 需要 把 任务 分 解 的 情况 ， 例 如 拆 分 出 多 个 子 任务 交 给 不 同 的 人 办 理 ， 在 Activiti 中 可 以 通过 TaskService 接 口 创建 子 任务 或 者 根据 父 任务 查询 子 任务 。 
创建 子 任务 的 方式 相对 来 说 比较 简单 ， 通 过 API 创 建 一 个 任务 并 设置 父 任务 ID， 最 后 保存 即 可 ， 当 然 可 以 同时 设置 该 任务 的 其 他 属性 (可 以 是 Task 对 象 支持 的 所 有 属性 ) 。 


图 12-19 展 示 了 表单 中 的 子 任务 区 域 ， 单 击 “ 添 加 ”按钮 创建 一 个 子 任务 ， 在 按钮 的 下 方 列 出 了 子 任务 列表 ， 并 且 根 据 任 务 是 否 已 结束 决定 是 否 显示 “完成 时 间 ” 文 字 。 


任务 办 理 一 [领导 审批 ] ， 痪 程 定 多 ID: [purchase-subprocess:1:10] 


画 到 期 日 : 2013-03-29 加 优先 级 : 高 而 创建 日 期 : 2013-03-14 07.52:11 


访 任 务 无 将 述 。 嘱 m ' 住 各 省 述 信 息 


任务 人 员 


上 拥有 人 ;amy 上 办理 人 ， kermit 


参与 人 amy 一 页 献 人 (参与 人 ) 鞭 删除 
候 赐 [人 | 组 ] henry -- 总 既 理 【参与 人 ) 其 唱 防 
jenny -- 技术 顾问 【参与 人 ) 其 吕 院 
deptLeader 一 悍 选 组 其 删除 
amy 一 惧 造 人 美 删 除 


ff 务 。 节 3 


图 12-19 在 任务 表单 中 添加 了 子 任务 区 域 


单 击 图 12-19 中 的 “添加 ”按钮 会 弹出 如 图 12-20 所 示 的 对 话 框 ， 任 务 名 称 和 任务 描述 与 Task 对 象 的 属性 对 应 ， 为 了 方便 讲解 这 里 仅 定 义 了 两 个 参数 ， 其 他 的 参数 读者 可 以 自行 添加 。 单 击 “确定 添 


加 ”按钮 后 提交 表单 ， 然 后 在 后 台 控 制 器 中 根据 请 求 参数 创建 任务 并 设置 任务 的 父 任务 ID， 实 现代 码 见 代码 清单 12-8。 


任务 名 称 : ”| 子 任务 333 


任务 描述 : | 子 任务 描述 信息 


图 12-20 ”添加 子 任务 对 话 框 


代码 清单 12-8 ”添加 子 任务 控制 器 


QRequestMapping ("task/subtask/add/ {taskId}") 

public String addSubTask (QPathVariable ("taskId") String parentTaskId,HttpSession-session, 
QRequestParam("taskName") String taskName, 

QRequestParam(value = "description", required = false) String description) 1 
Task newTask = taskService.newTask(); // 创建 一 个 新 的 任务 
newTask.setParentTaskId (parentTaskId); // 设置 父 任 务 ID， 建 立 上 下 级 关系 
String UserId = UserUtil.getUserFromSession(session) .getIqd(); 
newTask.setOwner (userId); // 设置 拥有 人 

newTask.setAssignee (userId); // 设置 办 理 
newTask.setName (taskName); // 设置 任务 名 称 
newTask.setDescription (description); // 设置 任务 描述 
taskService.saveTask (newTask); // 保存 任务 

return "redirect:/chapter6/task/getform/" + parentTaskId; 


刷新 页 面 之 后 即 可 看 到 名 称 为 “ 子 任务 333” 的 子 任务 ， 如 图 12-21 所 示 。 单 击 子 任务 列表 的 链接 即 可 打开 任务 办 理 界面 ， 如 图 12-22 所 示 。 当 然 可 以 继续 在 子 任务 中 添加 子 任务 ， 最 终 将 形成 一 棵 树 状 


(完成 时 间 : 2013-03-17 09:27:02) 
子 任 务 1111 ”其 删除 
号 子 任务 2222 其 删除 
任务 333 其 删除 
理 一 [ 子 任务 333] 


画 到 期 日 : 无 到 期 日 并 优先 级 : 中 创建 日 期 : 2013-03-19 07:02:27 


有 该 任务 属于 : 叔 导 审批 


图 12-22 子 任 务 办 理 界 面 


第 6 章 介绍 了 通过 TaskService#createTaskQuery() 创 建 TaskQuery 对 象 后 根据 条 件 查 询 任务 集合 ， 也 介绍 了 引擎 为 提高 运行 速度 把 流程 数据 状态 划分 为 运行 中 与 历史 (也 可 称 之 为 归档 ) 两 种 类 型 ， 每 


一 种 状态 对 应 不 同 的 数据 表 ， 在 一 个 用 户 任务 执行 完成 后 将 该 任务 从 运行 时 任务 表 (ACT_RU_TASK) 中 删除 ， 并 设置 历史 任务 (ACT_HI_TASKINST 表 ) 的 结束 时 间 ， 因 为 这 两 张 表 的 主键 ID 是 相同 的 ， 所 


\ 一 /一 


以 可 以 根据 运行 时 任务 1D 查 询 历史 任务 ， 当 然 如 果 一 个 历史 任务 还 没有 结束 ， 也 可 以 查询 运行 时 任务 。 


为 了 兼容 运行 时 与 历史 类 型 的 任务 数据 需要 利用 HistoryService 接 口 查询 历史 任务 实例 ， 在 代码 清单 6-26 中 追加 代码 清单 12-9 的 代码 用 于 查询 子 任务 及 上 级 任务 。 
代码 清单 12-9 ”查询 子 任务 及 上 级 任务 


// 读 取 子 任务 
LiSst<HiSstoricTaskInstance> SubTasks = historyService.createHistoricTaskInstanceQuery () 
.taskParentTaskId (taskId) .list (); 
mav.addobject ("subTasks", subTasks); 
// 读 取 上 级 任务 
if (task != null && task.getParentTaskId() != null) { 
HistoricTaskIinstance parentTask = historyService.createHistoricTaskIinstanceQuery () 
.taskId (task.getParentTask1Id()) .singleResult () ， 
mav.addobject ("parentTask", parentTask); 


} 


在 任务 表单 页 面 循环 输出 ModelAndView 对 象 中 的 “subTasks” 即 可 得 到 如 图 12-21 所 示 的 子 任务 列表 ， 根 据 单 个 任务 的 “结束 时 间 ” 是 否 为 空 决 定 如 何 显示 任务 信息 。 图 12-21 中 的 第 一 条 子 任务 已 
经 处 理 完成 ， 所 以 显示 的 图 标 与 未 完成 的 任务 不 同 ， 并 且 显 示 了 任务 完成 时 间 。 

要 办 理 任务 ， 单 击 图 12-21 中 的 任务 链接 打开 任务 表单 ， 但 是 需要 区 分 该 任务 是 否 已 结束 ， 如 果 已 经 结束 ， 需 要 使 用 历史 任务 查询 功能 并 显示 只 读 的 任务 界面 ， 如 果 任 务 未 结束 且 该 任务 的 办 理 人 与 当 
前 登录 人 匹配 ， 可 以 办 理 任务 。 


代码 清单 12-10 展 示 了 历史 任务 控制 器 ， 可 以 根据 任务 ID 查询 历史 任务 、 父 任务 以 及 子 任务 ， 最 后 返回 只 读 的 任务 界面 。 


代码 清单 12-10 ”历史 任务 查询 控制 器 


@QRequestMapping (value = "task/archived/{taskId}") 
public ModelAndView ViewHistoryTasK ( 
QPathVariable ("taskId") String taskId) throws Exception { 

String viewName = "chapter6/task-form-archived"; 

ModelAndView mav = new ModelAndView (viewName) ， 

HistoricTaskInstance task = historyService.createHistoricTaskInstanceQuery () 

.taskId (taskId) .singleResult ();，; 

if (task.getParentTaskId() != null) { 

HistoricTaskInstance parentTask = historyService.createHistoricTaskIinstanceQuery () 

.taskId (task.getParentTask1d()) .singleResult () ， 
mav.addobject ("parentTask", parentTask); 


} 

mav.addobject ("task", task); 

// 读 取 子 任务 

List<HistoricTaskinstance> SubTasks = historyService.createHistoricTaskInstanceQuery () 
.taskParentTaskId (taskIdq) .Li1st() 

mav.addobject ("subTasks", subTasks); 

return mav; 


代码 清单 12-10 中 返回 的 视图 “task-form-archived” 与 任务 表单 “task-form” 视图 类 似 ， 仅 仅 显 示 任 务 相 关 数 据 ， 不 可 以 添加 、 更 改 。 
第 9 章 介绍 了 与 任务 相关 的 意见 通过 流程 实例 ID 查询 ， 但 是 添加 的 子 任务 没有 设置 流程 实例 ID， 所 以 对 于 子 任务 而 言 就 不 能 正常 添加 、 读 取 意 见 列表 了 ， 为 此 需要 对 第 9 章 中 的 代码 做 一 些 更 改 以 支持 子 
任务 。 


在 第 9 章 中 根据 流程 实例 ID 查询 Comment， 而 对 于 子 任 务 没 有 流程 实例 的 情况 需要 使 用 下 面 的 代码 查询 Comment: 


List<Comment> comments = taskService.getTaskComments (LaskId) ， 


12.3 ”手动 任务 


在 Activiti Explorer 的 主 界面 中 单 击 “New Task” 按 钮 ， 弹 出 图 12-23 所 示 的 对 话 框 ， 与 新 增 子 任务 的 界面 类 似 ， 通 过 这 种 方式 创建 的 任务 和 流程 无 天 ， 可 以 作为 日 常 办 公 中 的 一 个 辅助 功能 。 


New Task 


Description 


图 12-23 Activiti Explorer 的 创建 新 任务 对 话 框 
如 何 创建 一 个 新 任务 在 介绍 子 任务 时 已 经 详细 讲解 了 ， 所 以 本 节 只 给 出 实现 的 效果 ， 读 者 可 自行 参考 本 书 配套 资源 中 的 代码 实现 。 


首先 在 任务 列表 添加 了 一 个 “新 任务 ”按钮 ， 如 图 12-24 所 示 ， 单 击 此 按钮 弹出 如 图 12-25 所 示 的 新 任务 对 话 框 ， 相 比 子 任务 的 新 增 对 话 框 多 出 了 优先 级 、 到 期 日 属性 ， 然 后 单 击 “ 创 建 ” 按 钮 提交 表 
单 ， 刷 新 页 面 显示 如 图 12-26 所 示 的 任务 表单 。 


到 任务 列表 号 管 理 v 2 Kermit Miao/kermit™ 


父 任务 ID 任务 创建 时 间 办 理 人 六 新 任务 


图 12-24 ”在 任务 列表 中 添加 了 “新 任务 ”按钮 


性 务 名 种: ”| 去 XXX 客户 车 订 舍 同 


性 务 描 述 | 携带 资料 : 告知 书 


高 
20| dUd-20 


关闭 “” 攻 汗 : 浊 


图 12-25 ”添加 新 任务 对 话 框 


性 细 天 理 一 [天 XXX 守 户 琶 订 合同 ] 
是 到 期 日 : 2013-03-20 轩 供 先 蝶 ; 两 图 创建 日 期 2013-039-19 11:36:41 


图 12-26 创建 的 新 任务 


12.4 附件 


在 流程 流转 过 程 中 经 常会 附带 一 些 文件 ， 这 些 文件 由 不 同 的 任务 办 理 人 上 传 ， 一 般 还 会 经 过 多 次 审批 。 本 节 将 介绍 如 何在 任务 办 理 过 程 中 创建 、 上 传 、 读 取 、 删 除 附件 。 


一 般 的 企业 应 用 或 网 站 的 附件 类 型 为 文件 ,或 者 一 个 外 部 的 链接 。Activiti 对 这 两 种 方式 都 给 予 了 良好 的 支持 。 图 12-27 展 示 了 两 种 不 同类 型 的 附件 ， 第 一 种 为 PDF 格 式 的 文件 ， 第 二 种 是 一 个 链接 类 型 
的 附件 。 


地 址 : http wwwJkafeitu.rme 
描述 : 官方 网 站 


图 12-27 任务 相关 附件 


单 击 图 12-27 中 的 “添加 ”按钮 后 弹出 如 图 12-28 所 示 的 添加 附件 对 话 框 ， 针 对 不 同 的 附件 类 型 用 不 同 的 标签 页 区 分 ， 在 选择 了 “文件 ”类 型 后 把 选择 的 文件 以 二 进 制 流 的 方式 保存 到 数据 库 ， 若 选 
择 “Web 资 源 ”， 则 把 “URL” 的 值 保存 到 附件 对 象 (Attachment) 的 “url” 属 性 中 。 


引擎 针对 这 两 种 附件 类 型 分 别提 供 了 一 个 创建 附件 对 象 的 AP| ( 见 图 12-29) ， 调 用 了 TaskService#createAttachment(attachment) 之 后 可 以 得 到 一 个 附件 对 象 。 特 别 注意 的 是 在 该 方法 被 调用 之 后 附 
件 已 被 持久 化 到 数据 库 ， 如 果 需 要 更 改 附件 的 属性 ， 可 以 先 通过 TaskService#getAttachment(attachmentld) 查 询 附 件 对 象 ， 然 后 设置 附件 属性 (只 支持 名 称 和 描述 属性 的 更 改 ) ， 之 后 调用 
TaskService#saveAttachment(attachment) 更 新 附件 到 数据 库 。 


添加 附件 添加 附件 
重 文件 | 区 Web 资 源 目 文件 ， 世 Web 资 源 
名 称 : URL: 


描述 : 名 称 : 


No file chosen 


Choose File | 


图 12-28 添加 附件 


createAttachment 


Attachmaent createAttachment(String attachmentType, 
String taskId., 
String processlInastancelId, 
String attachmentName , 
String attachmentDescription, 
Inputstream content) 


Add a new attachment to a task and/or a process Instance and Use an Input stream to provide the content 


createAttachment 


Attachment createAttachment{(String attachmentType. 
String taskId., 
String processInstanceId, 
String attachmentName ， 
String attachmentDescription, 
String url]) 


Add a new attachment to a task and/ior a process Instance and Use an ur as the content 


图 12-29 创建 附件 的 两 个 API 


在 图 12-29 中 ， 两 个 方法 前 5 个 参数 的 含义 都 是 相同 的 ， 可 以 设置 附件 对 象 的 类 型 、 任 务 1D、 流 程 实例 ID、 附 件 名 称 、 附 件 描述 信息 ; 唯一 不 同 的 是 最 后 一 个 参数 ， 第 一 个 方法 的 最 后 一 个 参数 可 以 接收 
一 个 输入 流 (Inputstream) 对 象 ， 第 二 个 方法 的 最 后 一 个 参数 则 接收 一 个 字符 型 的 URL。 


代码 清单 12-11 列 出 了 创建 文件 类 型 附件 的 代码 ， 要 创建 “Web 资源 ”类 型 的 附件 ， 只 要 把 文件 对 象 换 成 字符 型 URL 人 参数 ， 把 附件 类 型 设置 为 “ur|” (不 再 列 出 具体 的 代码 ) 。 本 例 的 代码 见 


me/kafeitu/activiti/web/chapter12/AttachmentController.java, 


代码 清单 12-11 创建 文件 类 型 的 附件 


RequestMapping (value = "new/file") 


@ 
public String newFile (GRequestParam("file") MultipartrFile file, HttpSession session) { #1 
String attachmentType = file.getContentType() + ";"+ 2 
FilenameUtils.getExtension (file.getOriginalFilename ()); #3 
identityService.setAuthenticatedUserId (UserUtil .getUserFromSession (session) .getId()); 
Attachment attachment = taskService 
.CreateAttachment (attachmentType, taskId, processInstancelId, 
attachmentName, attachmentDescription, file.getInputSstream()); 
return "redirect:/chapter6é/task/getform/" + taskId; 


} 


代码 清单 12-11 的 #1 处 接收 一 个 “MultipartFile” 对 象 (由 Spring MVC 提 供 ) ， 考 虑 到 文件 类 型 的 附件 上 传 以 后 要 能 够 下 载 ， 并 且 和 上 传 的 类 型 保持 一 致 ， 所 以 在 保存 附件 时 以 Web 资 源 的 实际 类 型 
作为 附件 的 类 型 (#2 处 ) ， 例 如 PDF 类 型 的 文件 对 应 “applicationypdf” ， 这 样 在 下 载 附件 时 通过 设置 HttpResponse 中 头 信息 的 “Content-Type” 属性 的 值 为 “application/ypdf” ， 浏 览 器 就 可 以 正确 
解析 。 


#3 处 使 用 了 一 个 工具 类 来 获取 文件 的 扩展 名 ， 考 虑 到 从 文件 对 象 获取 的 “ContentType” 属 性 不 能 直接 识别 具体 类 型 ， 例 如 Excel 文 件 的 “ContentType” 为 “application/octet-stream”， 所 以 在 附 
件 类 型 后 面 再 追加 文件 的 扩展 名 ， 在 上 传 一 个 Excel 类 型 的 文件 后 附件 对 象 的 类 型 为 “application/octet-stream; xls” ， 这 样 当下 载 附件 时 就 可 以 根据 这 个 规则 解析 ， 从 而 把 一 个 二 进 制 流转 换 成 一 个 文件 
流 输出 到 浏览 器 。 如 何 下 载 文件 类 型 的 附件 可 以 参见 代码 清单 12-12。 


代码 清单 12-12 下载 附件 


@QRequestMapping (value = "download/{attachmentId}") 

public void downloadFile (GPathVariable("attachment1Id") String attachmentId, HttpServiletResponse response) throws IOException { 
// 查询 附件 对 象 
Attachment attachment = taskService.getAttachment (attachmentIQ) ， 
// 读 取 附件 的 二 进 制 流 

InputStream attachmentContent = taskService.getAttachmentContent (attachmentId) 

// 根据 规则 获取 文件 的 类 型 

tring contentType = StringUtils.substringBefore (attachment .getType(), ™;"); 

esponse.addHeader ("Content-Type", contentType + ";charset=UTF-8"); 

/ 根据 规则 获取 文件 的 扩展 名 

tring extensionFileName = StringUtils.substringAfter (attachment .getType(), ™;"); 

/ 以 附件 名 字 和 扩展 名 作为 下 载 的 文件 名 

tring fileName = attachment .getName () + "." + extensionFileName; 

response.setHeader ("Content-Disposition", "attachment; filename=" + fileName); 

IOUtils.copy (new BufferedInputStream(attachmentContent), response.getOutputSstream()); 


~ 一 


~ 一 


CO 


OA 有 


在 了 解 了 如 何 创建 、 下 载 附 件 之 后 ， 要 下 载 附 件 ， 前 提 是 要 把 已 经 上 传 的 附件 展示 给 用 户 ， 并 且 根 据 附件 类 型 使 用 不 同 的 处 理 方式 ;在 上 传 附件 的 同时 传递 了 任务 1D 与 流程 实例 ID， 根 据 需求 不 同 可 以 
使 用 不 同 的 方式 查询 附件 。 


下 面 的 代码 分 别 根据 任务 ID 和 流程 实例 ID 查询 附件 : 


List<Attachment> attachments = 

taskService.getTaskAttachments (LaskId) 

List<Attachment> attachments = taskService 
.getProcessInstanceAttachments (processInstancelId); 


~ 一 


删除 附件 与 删除 任务 类 似 ， 具 体 代码 如 下 : 


taskService.deleteAttachment (attachmentId); 


~ 一 


12.5 ”改进 意见 列表 


有 些 读者 可 能 在 上 传 、 删 除 附件 时 发 现 “ 意 见 列表 ”显示 不 正确 ， 比 如 图 12-30 中 的 “null”。 回 想 一 下 第 9 章 ， 意 见 列 表 是 为 了 在 任务 办 理 时 允许 办 理 人 、 候 选 人 、 参 与 人 发 表意 见 。 除 了 用 户 自行 添 
加 的 意见 之 外 ， 引 擎 还 会 自动 把 一 些 事件 记录 在 意见 列表 ， 所 以 以 前 的 意见 列表 展示 代码 就 不 能 胜任 了 ， 最 终 导 致意 见 列表 显示 异常 。 本 小 节 将 详细 介绍 有 天 意见 的 其 他 用 途 。 


意见 列表 


1. null kermit (领导 审批 ) ”3/21/2013 7:30:28 PM 
2. null kermit (领导 审批 ) ”3/21/2013 12:02:08 AM 
3. 6ee kermit (领导 审批 ) ”3/17/2013 1:52:17 AM 


图 12-30 ”意见 列表 显示 异常 
图 12-31 展 示 了 意见 (Comment) 对 象 的 数据 ， 字 段 “TYPE_” 值 为 “comment” 表 示 手 动 添加 的 任务 办 理 意见 ， 值 为 “event” 表 示 由 其 他 操作 自动 插入 作为 操作 记录 存在 。 
字段 “ACTION “” 记录 了 每 一 条 记录 的 动作 类 型 ，“AddComment” 表 示 手 动 添加 的 意见 ，“AddAttachment” 表示 该 记录 是 在 创建 附件 时 由 引擎 自动 创建 的 。 
此 外 ,， 当 “ACTION ”字段 的 值 为 “AddUserLink ”或 “DeleteUserLink” 时 ， 表 示 添 加 参与 人 或 者 删除 参与 人 由 引擎 自动 插入 。 “MESSAGE_“” 字段 的 值 表示 了 操作 动作 ， 例 如 ， 当 动作 


为 “AddUserLink” 且 消息 为 “jenny | candidate” 时 ， 表 示 用 户 jenny 被 添加 到 任务 的 候选 人 列表 (也 可 以 是 自 定 义 的 参与 人 类 型 ， 参 考 12.1.3 节 ) 。 


SELECT * FROM ACT_HI_COMMENT order by TIME_ desc; 


Dee [PE lusemip. een [OCSTDL HOC [MESAGE Ju 


1203 event |2013-03-21 2307:56.317| Ikermit AddUserLink tom | ， candidate nok 
1110 |event |2013-03-21 22:02 :08.265 Kerrmit | AddUserLink ljenny_|_candidate null 


1104|event |2013-03-21 19:30:28.568 kermit |22 11 AddAttachment | 合同 复印 件 .pdf 


1027 event |2013-03-21 00:02:08.035 |kermit 22 11 AddAttachment | 咖啡 龟 的 博客 null 
702 comment|2013-03-19 20:18:55.913|kermit 701 Addcomment “| 请 补充 文件 e694b6e68[ 


图 12-31 ACT_HI_ COMMENT 表 数据 

了 解 了 这 些 数据 的 来 源 就 可 以 根据 这 些 类 型 解决 意见 列表 的 “null ”问题 ， 可 以 根据 不 同 的 类 型 使 用 文字 加 以 说 明 ， 下 面 给 出 了 一 些 示例 。 
. AddComment: 发 表 了 意见 。 

. DeleteComment: 删除 了 意见 。 

. AddUserLink: 添加 了 候选 人 或 者 参与 人 。 

* DeleteUserLink: 删除 了 候选 人 或 者 参与 人 。 

. AddGroupLink: 添加 了 候选 组 。 

. DeleteGroupLink: 删除 了 候选 组 。 

. AddAttachment: 添加 了 附件 。 


“ DeleteAttachment: 删除 了 附件 。 


根据 上 面 的 规则 ， 在 显示 意见 时 加 以 处 理 即 可 显示 如 图 12-32 所 示 的 结果 。 有 一 点 需要 注意 ， 当 涉及 添加 或 删除 候选 人 、 候 选 组 时 流程 1D 字段 (PROC _INST_ID) 为 空 ， 这 样 仅 根 据 流程 实例 ID 查询 事 
件 列表 得 不 到 完整 的 结果 列表 ， 所 以 本 例 在 读 取 事件 列表 时 传递 了 taskld 与 processinstanceld 两 个 参数 ， 后 台 会 分 别 查 询 并 把 结果 合并 到 一 个 集合 


| 亲口 


@@ 说 明 由 于 现在 的 “意见 列表 ”显示 的 数据 已 经 不 单单 是 手动 添加 的 意见 了 ， 图 12-32 中 混合 了 意见 、 附 件 、 候 选 人 、 候 选 组 以 及 自 定义 参与 人 类 型 的 操作 事件 ， 所 以 把 “意见 ”更 名 为 “事件 ”更 
为 合理 。 


添加 了 附件 : 咖啡 免 的 博客 【领导 审批 ) 3/21/2013 12:02:08 AM 
邀请 了 jenny 作为 [ 技术 顾 间 ] ( 额 导 审 批 ) 3/16/2013 7:46:29 PM 
邀请 了 amy 作为 [ 贡献 人 ] 【领导 审批 ) 3/16/2013 7:11:25 PM 


邀请 了 amy 作为 [ 悍 选 人 ] (领导 审批 ) 3/17/2013 1:28:37 PM 

邀请 了 amy 作为 [ 拥有 人 ] (领导 审批 ) 3/17/2013 1:20:23 AM 
添加 了 附件 : 咖啡 免 的 博客 【领导 审批 ) 3/21/2013 12:02:08 AM 

添加 了 [ 候选 组 ] deptLeader (领导 审批 ) 3/17/2013 1:28:08 PM 

全 表 了 意见 : 因为 王 总 出 美 此 任务 下 天 (领导 审批 ) 3/22/2013 12:20:24 


DMN 


图 12-32 ”改进 后 的 意见 列表 


为 了 能 够 兼容 不 同类 型 的 事件 并 给 出 正确 合理 的 中 文 说 明 ， 为 此 专门 写 了 一 个 事件 转换 器 ， 读 者 可 以 查看 本 书 配套 资源 中 本 章 源码 的 src/main/webapp/js/modules/chapter12/events.js 文 件 了 解 处 理 
过 程 ， 由 于 篇 幅 有 限 ， 这 里 不 再 详 细 介 绍 。 


12.6 任务 委派 


任务 委派 是 任务 管理 范畴 内 一 个 比较 重要 的 功能 ， 简 答 来 说 就 是 一 个 任务 本 来 分 配给 用 户 A (委派 人 ) ， 但 是 A 由 于 某 些 原因 不 能 处 理 该 任务 ， 可 以 把 这 个 任务 委派 给 用 户 B (被 委派 人 ) 代理 ， 在 用 户 B 
处 理 完成 后 将 任务 再 次 回归 给 用 户 A。 在 整个 过 程 中 用 户 A 是 该 任务 的 拥有 人 (Owner) ， 用 户 B 是 该 任务 的 办 理 人 (Assignee) 。 图 12-33 用 流程 图 的 方式 展示 了 任务 委派 的 原理 。 


从 组 织 树 中 选择 一 个 


任务 来 源 可 以 是 签收 | 组织 树 过 所 


也 可 以 直接 分 配 “| 


图 12-33 ”任务 委派 原理 


12.6.1 ”单元 测试 


引擎 提供 了 专门 的 API 处 理 任 务 委派 ， 而 且 处 理 被 委派 的 任务 时 必须 使 用 特定 的 API 才 可 以 。 图 12-34 是 一 个 很 简单 的 流程 图 ， 配 合 代码 清单 12-13 可 以 展示 如 何在 Activiti 中 实现 任务 委派 。 


taskDelegate 这 


图 12-34 ”简单 的 任务 委派 流程 


图 12-34 的 主要 XML 代 码 如 下 : 


<process id="taskDelegateProcess" name=" 任 务 委派 "> 
<userTask id="delegatedTask" name=" 用 户 任务 " 
activiti:assignee="$ {userId}"></userTask> 


</process> 


代码 清单 12-13 ”任务 委派 单元 测试 


public class TaskDelegateTest extends PluggableActivitiTestCase { 
@Deployment (resources = "diagrams/chapter12/taskDelegate .bpmn") 
public void testTaskDelegate() throws Exception 
Map<String, Object> variables = new HashMap<String, Object> () ， 
String userId = "bill"; // 委派 人 
variables.put ("userId", userId); 
runtimeService.startProcessInstanceByKey ("taskDelegateProcess", variables); 
Task task = taskService.createTaskQuery() .taskAssignee (userId) .singleResult 1() ， 
assertNull (task.getOwner()); // 第 一 次 叙 分 配 任务 后 拥有 人 为 空 
String delegatedUserId = "henryyan"; // 被 委派 人 
taskService.delegateTask (task.getId()，delegatedUserId); ”// 执行 委派 任务 操作 #1 
// 查看 数据 状态 
task = taskService.createTaskQuery() // 查询 被 委派 昌 未 处 理 的 任务 
.taskDelegationState (DelegationState .PEND ~ #2 
.taskAssignee (delegatedUserId) .singleResult ( 
0 getOwner(), userId); // 3 和 购 搁 省 人 为 bi11 
assertE s(task.getAssignee (),，delegatedUserId); // 委派 任务 的 办 理 人 为 henryyan 
// 被 委派 人 处 理 完成 任务 
taskService.resolveTask (task.getId()); // 被 委派 人 完成 任务 #3 
// 任务 回归 到 委派 人 
task = taskService.createTaskQuery() // 查询 被 委派 且 已 经 处 理 完 成 的 任务 
RSs | coal On ele (De ey on ate RESOLVED) #4 
.taskAssignee (user] [d) .singleResult () ， 
assertE a s(task.getOwner(), userId); // 被 委派 的 任务 完成 后 拥有 人 和 办 理 人 均 为 bill 
assertEquals (task.getAssignee()，userId) ， 
// 委派 人 完成 任务 
taskService.complete (task.getId()); 
long count = historyService.createHistoricProcessInstanceQuery() .finished() .count (); 
assertEquals (1, count); 


一 


代码 清单 12-13 用 单元 测试 的 方式 阐述 了 任务 委派 的 过 程 ， 在 #1 处 调用 委派 API 把 bil 的 待 办 任务 委派 给 用 户 henryyan， 此 时 任务 的 所 有 人 是 bill 即 原 任务 的 办 理 人 ; 接着 在 #2 处 创建 任务 查询 对 象 查询 
所 有 委派 给 用 户 henryyan 的 任务 ， 即 委派 状态 为 “pending” 的 任务 ， 此 时 任务 的 拥有 人 是 bill， 而 办 理 人 是 henryyan。 


#3 处 与 #1 处 相对 应 ， 被 委派 人 完成 被 委派 的 任务 ， 此 时 拥有 人 、 办 理 人 均 为 bill， 并 且 该 任务 的 委派 状态 为 “resolved”.。 


12.6.2 ”任务 表单 中 的 委派 


在 了 解 了 任务 委派 的 原理 及 执行 过 程 后， 下 面 把 委派 功能 添加 到 任务 表单 中 。 图 12-35 中 加 边框 部 分 是 针对 任务 委派 添加 的 ， 单 击 任务 委派 后 的 文字 可 以 选择 一 个 委派 人 ， 选 择 委派 人 之 后 任务 的 委派 
状态 将 会 改变 ， 如 图 12-36 所 示 ， 同 样 在 任务 列表 中 也 可 以 看 到 任务 的 委派 状态 ， 如 图 12-37 所 示 。 


半 程 定 XID: [purchase-subprocess:1:10] 


基 到 期 日 : 2013-03-29 旧情 先 狼 : 中 图 创建 日 期 : 2013-03-14 07:52:11 


流 性 务 无 摘 述 ， 


E 务 人 员 


拥有 人 : bil 主办 理 ,人 : bil 有 证 名 委派 : Y Amy Zhang 
Andy Zhac 
参与 人 amy 一 贡献 人 (参与 人 ) 。 其 删除 en 
息 选 [人 | 组 ] henry 一 总 经 理 【参与 人 ) 半 删除 

jenny -- 技术 顾问 《参与 人) 其 册 陈 Jenny Luo 
deptLeader -- 尿 和 这 坦 其 出 陈 Kermit Miao 
aimy 一 导 填 人 其 骨 陈 Thomas Wang 
jenny -- 怪 选 人 其 利 陈 Tom Wang 
tom -- 翌 选 人 人 其 融 陈 Tony Zhang 


图 12-35 ”在 任务 表单 中 添加 了 任务 委派 功能 


所 有 人 : bil 生 办 理 人 : bill 胜任 务 秋 派 : 被 委派 


图 12-36 ”任务 委派 状态 : 被 委派 


Activiti Explorer 向 首页 。” 贸 请 蛋 【普通 表单 ) = | 至 在 考 列 表 如 管理 = 里 Henry Yanihenry = 


任务 ID 任务 吉 称 让 各 实例 ID” 让 程 定 凡 ID 妥 性 务 ID， 任务 要 亚 状 态 ， 竹 务 创 建 时 间 办 理 人 | 期 作 
22 应 导 审 批 11 purchase-subprocess:1:10 无 太宰 要 娃 。 2013-03-14 O07:52:11 | henry 星 办 理 其 反 签 收 


图 12-37 任务 列表 显示 委派 状态 


任务 表单 和 任务 列表 中 人 处理 任务 委派 的 状态 可 以 参考 下 面 的 代码 ， 根 据 状态 显示 不 同 的 说 明文 字 。 


<c:if test="${task.delegationState == 'PENDING' }"> 
被 委派 

< 

<c:if test="${task.delegationState == 'RESOLVED' }"> 
任务 已 处 理 完成 

< /> 


从 图 12-36 中 可 以 看 出 ， 当 前 任务 的 拥有 人 是 bil， 选 择 的 被 委派 人 是 “Henry Yan”， 从 图 12-37 中 也 看 出 用 户 henry 有 一 条 待 办 任务 。 


单 击 任 务 表单 中 的 “完成 任务 ”按钮 ， 实 际 调用 的 是 TaskService#complete0) 方 法 ， 但 是 在 被 委派 的 任务 完成 时 必须 调用 代码 清单 12-13 中 #3 处 的 TaskService#resolveTask0 方 法 ， 否 则 被 委派 的 任务 
不 能 回归 给 委派 人 ， 所 以 针对 这 个 问题 需要 在 Task-Cotroller#complete() 控 制 器 中 对 任务 委派 进行 特殊 处 理 。 


TaskCotroller#complete() 首 先 会 查询 任务 是 否 存在 ,解决 委派 问题 可 以 在 其 后 加 入 下 面 的 代码 ， 根 据 任 务 的 委派 状态 判断 ， 如 果 处 于 委派 状态 ， 就 调用 特定 的 委派 回归 人 处理 方法 ， 否 则 按照 普通 任务 
处 理 。 
if (task.getDelegationstate () 二 DelegationState.PENDING) { 


taskService.resolveTask (taskId); 
return TASK LIST; 
} 


12.7 ”本章 小 结 


本 章 内 容 是 本 书 的 重点 ， 因 此 花费 了 大 量 的 篇 幅 详 细 介 绍 和 用 户 任务 有 关 的 概念 、 操 作 ， 在 一 般 的 流程 中 大 部 分 活动 都 是 用 户 任务 ， 是 以 流程 驱动 的 系统 与 用 户 交互 的 接口 。 
以 Activiti 官 方 Activiti Explorer 的 任务 办 理 界面 为 基准 ， 通 过 6 节 内 容 对 图 12-1 的 内 容 一 一 做 了 详细 讲解 并 实现 了 全 部 功能 。 


通过 对 任务 表单 的 改造 来 查看 、 修 改 任务 的 一 些 属性 ， 例 如 拥有 人 、 办 理 人 、 优 先 级 等 ; 介绍 了 新 增 的 添加 任务 相关 人 员 功 能 ， 可 以 动态 地 添加 候选 人 、 候 选 组 、 参 与 人 ， 并 对 每 一 种 类 型 的 人 员 做 了 
比较 说 明 ; 还 针对 任务 查询 做 了 改进 ， 进 而 可 以 查询 和 三 种 类 型 人 员 有 关 的 任务 。 


子 任务 是 在 现 有 任务 的 基础 上 添加 的 ， 如 果 在 任务 办 理 过 程 中 需要 对 任务 拆 分 ， 可 以 利用 引擎 的 子 任务 功能 实现 。 本 章 带 领 读者 学 习 了 如 何 创建 、 完 成 子 任务 以 及 子 任务 的 办 理 状态 。 与 此 类 似 的 还 有 
手动 任务 ， 它 和 子 任务 的 区 别 在 于 不 依赖 现 有 任务 直接 创建 一 个 独立 的 任务 。 


附件 也 是 本 章 内 容 的 重点 ， 虽 然 介绍 的 篇 幅 不 多 但 是 其 在 日 常 使 用 的 重要 性 不 容 忽视 。 本 章 介绍 了 可 以 为 办 理 的 任务 创建 两 种 不 同类 型 的 附件 (文件 、Web 资 源 ) ， 并 且 演 示 了 如 何 删除 、 读 取 附 件 内 


] 


功 
a 
O 


在 第 9 章 中 简单 介绍 了 利用 引 警 的 Comment 实 现 审批 意见 功能 ， 不 过 由 于 对 用 户 任务 的 一 系列 操作 “导致 ”引擎 自动 产生 了 一 些 “ 意 见 ”， 包 括 对 任务 相关 人 员 和 附件 的 添加 、 删 除 操作 记录 ， 所 以 最 
终 把 “意见 ”更 名 为 “事件 ”更 为 恰当 。 为 了 能 够 把 计算 机 能 识别 的 记录 转换 为 文字 ， 还 专门 写 了 一 个 Javascript 版 本 的 转换 器 以 供 读者 参考 。 


最 后 介绍 了 任务 委派 功能 ， 首 先 用 流程 图 的 形式 描述 了 委派 的 原理 ， 然 后 利用 一 个 简单 的 例子 结合 单元 测试 从 引擎 API 的 角度 去 学 习 ， 并 把 这 一 功能 加 入 到 了 Activiti Explorer 中 。 


第 13 草 “流程 数据 查询 与 跟 路 


实战 篇 是 本 书 比 较 核心 的 部 分 ， 占 据 了 本 书 主要 的 篇 幅 ， 在 本 章 之 前 学 习 了 如 何 启动 流程 、 完 成 任务 等 操作 ， 几 乎 每 个 操作 都 会 对 数据 库 产 生 影 响 ， 当 然 大 多 数 操作 都 是 向 数据 库 中 插入 数据 。 一 般 由 
流程 驱动 的 系统 会 提供 各 种 数据 的 查询 功能 ， 例 如 某 个 用 户 参 与 过 的 流程 、 跟 踪 流 程 办 理 状态 、 已 经 办 理 完成 (归档 ) 的 流程 。 本 章 将 针对 这 一 系列 查询 需求 进行 一 一 讲解 ， 介 绍 运 行 时 与 历史 数据 不 同 的 
查询 方法 ， 以 及 标准 查询 API 不 能 满足 复杂 查询 时 如 何 使 用 Native Query (使 用 基于 MyBatis 的 SQL 语句 方式 查询 ) 方式 自 定义 查询 。 


13.1 Query API 简 介 


Activiti 的 查询 API 分 类 两 类 : 标准 查询 与 Native 查 询 。 所 谓 标准 查询 是 在 以 Java 对 象 的 方式 通过 创建 一 个 指定 类 型 的 Query 对 象 (实现 Query 接 口 ， 图 13-1 的 左 半 部 分 ) 后 用 链 式 编程 的 方式 设置 查询 
参数 。 但 是 标准 查询 有 一 个 次 端 ， 不 支持 复杂 的 查询 ， 比 如 多 张 表 联 合 查 询 或 者 使 用 或 《SQL 的 OR 关键 字 ) 关系 查询 。 因 此 引擎 从 5.11 版 本 开始 提供 了 Native 查 询 ， 人 允许 采用 标准 SQL 的 方式 查询 流程 对 
象 ， 不 过 Native 查 询 仅 支持 部 分 流程 对 象 ， 并 且 查 询 对 象 需要 实现 图 13-1 右 半 部 分 的 NativeQuery 接 口 。 


图 13-1 中 的 两 个 基础 查询 接口 均 有 一 系列 特定 类 型 的 子 接口 ， 图 13-2 的 类 图 展示 了 标准 查询 的 子 接口 ， 图 13-3 展 示 了 Native 查 询 的 子 接口 。 


[2 QUery <..> @ NativeQu 下 TY < > 
wD ascl) T ww sql(String) T 
ww desc() T Ww parameter(String, Object) T 


ww count0 Iong ww countl) Iong 
Ww singleResult() U Ww singleResult() U 
ww list0 List<U> ww list0 List<U> 
Ww listPagelint, int) List<U> Ww listPage(int, int) List<U> 


图 13-1 ”标准 查询 与 Native 查 询 类 图 


B ProcessinstanceQuery @ HistoricProcessinstanceQuery 


转 ExecutionQuery @ HistoricTaskinstanceQuery 


TaskQuery 各 HistoricActivityInstanceQuery 


HistorlcDetailQuery 


@ ModelQuery 
南通 梧 肝 二 直 - 
“ou z HistoriceVariablelnstan 
及 BB Ouery<.> < @ HistoricVariableinstanceQuery 


于 本 
0 DeploymentOuery he 


UserQuery 


@ ProcessDefinitionQuery 


© jobQuery GroupQuery 


图 13-2 ”标准 查询 对 象 继承 关系 


@ NativeHistoricProcessinstanceQuery 


EB NativeProcesslnstanceaQuery NativeHistoricActivityInstanceQuery 


@ NativeQuery <,.> S 个 NativeExecutionQuery 


DB NativeTaskQuery \ 
转 NativeHistoricTasklInstanceQuery 


图 13-3 Native 查询 对 象 继承 关系 


本 节 的 主要 内 容 是 如 何 查询 运行 时 与 历史 数据 ， 图 13-4 (HistoryService) 、 图 13-5 (RuntimeService) 、 图 13-6 (TaskService) 分 别 列 出 了 创建 标准 查询 对 象 的 APl， 结 合 图 13-2 和 图 13-3 的 两 个 查 
询 对 象 类 图 很 容易 理解 Activiti 中 关于 查询 的 APl 是 如 何 设 计 的 。 


各 HistorySservice 

a createHistoricProcessinstanceGyu eryW HistoricProcessinstanceduery 
w) createHistoricActivitylinstanceQuery0 HistoricActivityinstanceQuery 
ww createHistoricTasklnstanceGuery() HistoricTasklnstanceQwery 
ww createHistoricDetallQueryt HistoricDetallQuery 


ww createHistoricvariablelnstanceQueryt) HistoricVvariablelnstanceQuery 
ww deleteHistoricTasklnstancelString) void 
“wD deleteHistoricProcessInstancelString) void 
ww createNativeHistoricProcessinstanceQueryy NativeHistoricProcessinstanceQuery 
ww createNativeHistoricTaskinstanceQuery( NativeHistoric TaskinstanceQuery 
ww createNativeHistoricActivityInstanceQuery) NativeHistoricActivitylnstanceQuery 


图 13-4 ”HistoryService 中 创建 查询 对 象 的 方法 


RuntimeService 


w createExecutionQuery0 ExecutionQuery 


ww createNativeExecutionQuery0 NativeExecutionQuery 
“w createProcessinstanceQuery( ProcesslnstanceQuery 
w createNativepProcesslnstanceQuery0 NativeProcessinstanceQuery 


图 13-5 ”RuntimeService 中 创建 查询 对 象 的 方法 


@ TaskService 
“WcreateTaskQuery0 TaskQuery 
ww) createNativeTaskQuery0 NativeTaskQuery 


图 13-6 ”TaskService 中 创建 查询 对 象 的 方法 


运行 时 数据 查询 主要 依赖 TaskService 与 RuntimeService 这 两 个 接口 ， 在 第 6 章 已 经 介绍 了 如 何 查 询 任务 数据 ， 第 12 章 又 针对 自 定 义 的 参与 人 更 改 了 任务 查询 方法 。 本 节 将 再 次 改造 任务 查询 以 支持 分 页 
查询 ， 并 添加 运行 中 流程 查询 以 便 用 户 跟踪 流程 办 理 的 进度 。 


通过 前 面 章节 的 学 习 我 们 知道 : 一 个 任务 一 旦 处 理 完成 将 流转 至 下 一 个 节点 ， 而 县 通常 下 一 个 节点 的 处 理 人 不 是 当前 人 ， 所 有 参与 过 流程 办 理 的 人 可 能 会 再 次 查看 或 跟踪 流程 办 理 的 进度 ， 例 如 当前 任 
务 正在 哪个 节点 由 谁 办 理 ， 甚 至 可 以 看 到 该 任务 是 否 被 签收 (如 果 有 候选 人 、 候 选 组 ) ， 还 可 以 查询 已 经 处 理 的 任务 的 办 理 情 况 等 再 详细 一 些 的 信息 ， 例 如 何 时 创建 任务 、 何 时 完成 任务 等 信息 。 


目前 的 任务 列表 是 把 已 经 签收 、 未 签收 、 受 邀 的 任务 分 开 查询 ， 然 后 汇总 到 一 个 集合 对 象 中 ， 在 实际 应 用 中 一 般 会 对 任务 列表 分 页 查询 ， 很 明显 目前 的 查询 方式 很 难 做 到 这 一 点 。 


利用 Native 查 询 很 容易 满足 分 页 查询 的 需求 ， 图 13-1 中 列 出 了 Native 查 询 的 几 个 方法 ， 其 中 “sql(String sqD)” 可 以 接受 一 个 标准 的 SQL 语句 ， 如 果 需 要 设置 参数 ， 可 以 用 Mybatis 的 语法 设置 。 下 面 列 
出 了 通过 Native 查 询 来 查询 任务 列表 的 代码 。 


List<Task> tasks = taskService.createNativeTaskQuery () 
.Sql ("SELECT * FROM " 十 
managementService.getTableName (Task.class) 
+ " T WHERE T.NAME = #{taskName}") 
.parameter ("taskName"，" 人 事 审批 ") .list(); 


首先 通过 TaskService 接 口 创 建 一 个 Native 方 式 的 任务 查询 对 象 ， 然 后 设置 SQL 语句 ， 其 中 表 名 可 以 通过 ManagementsService#getTableName() 方 法 获取 ， 条 件 以 MyBatis 的 格式 设置 (Native 查 询 方 
式 最 终 会 使 用 MyBatis 的 API 执 行 查询 ) ， 以 “# ”标注 一 个 参数 的 开始 ， 然 后 用 “{…}” 设置 参数 名 称 ， 最 后 用 链 式 编程 方式 调用 “parameter0” 方 法 设置 每 一 个 参数 的 值 。 


获取 结果 的 方式 与 标准 查询 相同 ， 方 法 “list0” 可 以 查询 所 有 结果 ， 方 法 “list-Page(firstResult，maxResult)” 可 以 分 页 查询 (Activiti 5.13 以 上 的 版 本 支持 ) 。 
代码 managementservice.getTableName(Task.class) 完 全 可 以 使 用 “ACT_RU_ TASK” 代替， 只 不 过 引擎 提供 了 接口 可 以 根据 流程 对 象 获 取 对 应 的 表 名 。 表 13-1 列 出 了 流程 对 象 与 表 名 的 对 照 关 系 。 


表 13-1 流程 对 象 对 应 的 数据 库 表 名 


类 名 表 名 


org.activiti.engine.task.Task ACT RU TASK 
org.activiti.engine.runtime.Execution ACT RU EXECUTION 
org.activiti.engine.runtime.Processlnstance ACT RU EXECUTION 
org.activiti.engine.repository.ProcessDefinition ACT RE PROCDEF 
org.activiti.engine.repository.Deployment ACT RE DEPLOYMENT 
org.activiti.engine.runtime..Job ACT RU JOB 
org.activiti.engine.history.HistoricProcesslnstance ACT HI PROCINST 
org.activiti.engine.history.HistoricActivitylnstance ACT HI ACTINST 
org.activiti.engine.history.HistoricDetail ACT HI DETAIL 
org.activiti.engine.history.HistoricVariableUpdate ACT HI DETAIL 
org.activiti.engine.history.HistoricFormProperty ACT HI DETAIL 
org.activiti.engine.history.HistoricTasklnstance ACT HI TASKINST 
org.activiti.engine.history.HistoricVariablelnstance ACT HI VARINST 


代码 清单 13-1 使 用 Native Query 分 页 查询 


Page<Task> page = new Page<Task> (PageUtil .PAGE SIZE); 

int[] pageParams = PageUtil.init (page, request); 

String sql = "select distinct RES.* from ACT RU TASK RES left join 
"ACT RU IDENTITYLINK I on I.TASK ID = RES.ID WH ' 


FRFE "+ 
( RES.ASSIGNEE = #{userId}" + /7 已经 签收 或 者 直接 分 配 的 ”村 
| 


"or (RES.ASSIGNEE js null and ( I.USER ID = #{userId} or I.GROUP ID IN (select 
G.GROUP ID from ACT ID MEMBERSHIP G where G.USER ID = #{userId} ) )" + 
)" + filters + " order by RES.CREATE TIME desc"; 


NativeTaskQuery query = taskService.createNativeTaskQuery () .sql (sql) 
.Parameter ("userild", user.get1Id()); 


List<Task> tasks = query.listPage (pageParams[0], pageParams [1]); 
page.setResult (tasks); 
page.setTotalCount (query.sql ("select count (*) from (" + sgl + ")") .count()); 
// 统计 总 数 

mav.addobject ("page", page); 


代码 清单 13-1 对 两 种 类 型 的 任务 进行 了 合并 查询 ， 其 结果 和 之 前 的 标准 查询 一 致 ， 查 询 后 的 结果 如 图 13-7 所 示 。#1 处 语句 对 应 如 下 的 标准 查询 : 


~ 一 


taskService.createTaskQuery () .taskAssignee (userId) 


#1 处 后 面 的 语句 对 应 如 下 的 标准 查询 ， 结 果 包 含 了 候选 人 、 候 选 组 、 其 他 类 型 的 参与 人 学 围 内 的 任务 。 


~ 一 


taskService.createTaskQuery () .taskInvolvedUser (userId 


任务 名 各 流程 实例 ID 流程 定义 ID | 父 任务 |D 任务 委派 状态 | 任务 创建 时 间 


新 任务 --XXXX 2013-03-22 12:24:59 


新 任务 5555 2013-03-30 01:28:193 


去 XXX 客 户 签订 合同 2013-03-19 11:38:41 


新 任务 2222 2013-03-29 09-12-439 


新 性 务 333 2013-03-29 09:13:02 


图 13-7 通过 NativeQuery 分 页 查询 任务 


当然 在 图 13-7 中 的 列表 还 可 以 添加 根据 任务 名 称 或 者 其 他 属性 的 过 滤 条 件 ， 如 图 13-8 所 示 ， 在 “任务 名 称 ” 中 添加 了 查询 条 件 ， 过 滤 出 任务 名 称 中 包含 “合同 ”的 待 办 任务 。 


任务 名 称 : 


任务 ID” 任务 名 称 流程 实例 ID ”流程 定 光 ID ， 父 任务 ID 任务 委派 状态 ” 任务 创建 时 间 办 理 人 操作 新 任务 


B01 去 XXX 塞 门 答 1] 容 后 2013-03-19 11:38:41 | kermlit 里 办 理 其 后 签 监 


图 13-8 在 任务 列表 中 添加 过 滤 条 件 


在 代码 清单 13-1 的 基础 上 加 以 改进 即 可 实现 条 件 过 滤 ， 修 改 后 的 代码 如 下 : 


NativeTaskQuery cuery = taskService.createNativeTaskQuery () ， 
String filters = " "7 

if (StringUtils.isNotBlank (taskName)) { 

filters += " and RES.NAME like #{taskName}"; 
query.parameter ("taskName", "%" + taskName + "%$");}; 
mav.addobject ("taskName", taskName); 


} 
String assignedqSal = "select http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15030/0EBPS/Text/... "+ filters; 
String claimOorLinkedSgl = "select http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15030/0EBPS/Text/... "+ filters; 


这 样 ， 在 图 13-8 中 的 “任务 名 称 ”输入 框 中 输入 “合同 ”文字 后 再 查询 就 可 以 过 滤 出 任务 名 称 包 含 “ 合 同 ” 的 任务 。 


13.2.2 ”查询 参与 的 流程 


在 本 节 开 始 的 时 候 提 出 了 一 个 需求 ， 查 询 已 经 办 理 过 的 流程 以 及 跟踪 流程 办 理 情况 。 在 前 面 的 章节 中 已 经 多 次 使 用 标准 查询 来 查询 流程 运行 中 的 流程 实例 ， 代 码 如 下 : 


List<ProcessInstance> processInstanceList = 
runtimeService .createProcessInstanceQuery () .list (); 
List<Execution> executionList = 

runtimeService .createExecutionouery() .list (); 


在 第 9 章 中 已 经 介绍 过 Processlnstance 与 Execution 的 不 同 了 ， 两 者 是 一 对 多 的 关系 ， 所 以 processlnstanceList 的 结果 数量 会 “大 于 等 于 ”executionList 的 结果 数量 。 


查看 ProcesslnstanceQuery 与 ExecutionQuery 对 象 的 API 没 有 直接 查询 某 个 用 户 参 与 过 的 流程 ， 所 以 需要 通过 Native 查 询 实现 。 图 13-9 展 示 了 新 添加 的 “参与 的 流程 ”列表 ， 自 定义 的 SQL 如 下 : 


NativeExecutionQuery nativeExecutionQuery = 
runtimeService.createNativeExecutionQue 
String sql = "select RES.* from ACT RU EXECUTION RES 
ACT HI TASKINST ART on ART.PROC INST ID = 
RES.PROC INST ID 四 
where ART.ASSIGNEE = #{userId} and ACT ID is not null 
and IS ACTIVE = 'TRUE' order by START TIME desc"; 


() ; 
eft join 


以 上 代码 位 于 me.kafeitu.activiti.web.chapter13.ExecutionController.java 文 件 中 ( 见 代 码 清单 13-2)，JSP 文 件 位 于 chapter13/src/main/webapp/WEB-INF/views/chapter13/execution-list.jsp。 
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滞 任 务 列表 


流程 实例 ID 流程 定 巡 ID ee 当前 节点 


11 purchase-subprocess:1:10 deptLeaderAudit 


共 1 亲 数据 | < 


图 13-9 ”参与 的 流程 列表 


注意 ， 图 13-9 中 “当前 节点 ” 列 显示 的 数据 与 设计 流程 时 的 任务 ID 相同 ， 且 仪 通过 流程 定义 1D 用 户 不 能 区 分 出 是 哪 一 个 类 型 的 流程 (用户 体验 非常 差 ) ， 针 对 这 两 点 需要 做 一 些 “ 翻 译 ” 的 工作 ， 把 计 
算 机 所 表达 的 数据 翻译 成 用 户 能 看 懂 的 文字 ， 效 果 如 图 13-10 所 示 。 


前 首 页 ”器 请 假 (普通 表单 )* ”器 运行 中 = | 器 管理 ~ 里 Kermit Miao/kermit™ 


流程 实例 上 ”所属 流程 流程 定 兆 ID 当前 节点 
1760 办 心 用品 了 网 purchase-subprocess:2:1316 财务 审批 【未 签收 ) 普通 流 程 
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| 


图 13-10 ”在 参与 的 流程 列表 中 翻译 了 当前 节点 名 称 


根据 当前 处 于 活动 的 任务 类 型 划分 为 普通 流程 、 调 用 活动 、 子 流程 。 普 通 流程 类 型 的 Execution 对 象 的 “activityld” 值 为 在 流程 定义 中 定义 的 活动 |D。 如 果子 流程 处 于 活动 状态 ， 则 流程 实例 


的 “activityld” 值 为 空 目 活动 状态 为 “FALSE” 


“通用 付款 流程 ”。 


( 表 ACT_RU_EXECUTION 中 的 IS_ACTIVE 字段 ) ， 
与 子 流程 类 似 但 也 有 不 同 ， 如 果 调 用 活动 处 于 活动 状态 ， 可 以 根据 当前 流程 的 流程 ID 查询 相关 子 流程 。 图 13-10 中 第 二 条 记录 是 一 个 “办 公用 
财务 审批 ”表示 当前 活动 的 任务 属于 


由 其 派生 的 Execution 对 象 处 于 活动 状态 并 通 


过 字段 “PARENT ID“ 
品 采 购 -callactivity 方 式 ” 流 程 ， 当 前 节点 为 “通用 付 


与 流程 3 


实例 建立 关系 。 调 用 活动 


ETN 
款 流程 - > 


代码 清单 13-2 中 使 用 内 部 的 非 公 开 类 ExecutionEntity， 目 的 是 获取 当前 的 活动 |D， 但 是 在 Activiti 5.13 版 本 之 前 直接 通过 Execution 接 口 不 能 获取 ， 需 要 强制 类 型 转换 为 ExecutionEntity 后 再 获 取 ,， 或 
者 通过 反射 的 方式 来 获取 。 


代码 清单 13-2 ”查询 参与 的 流程 列表 
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图 13-10 中 显示 的 “所 属 流程 ”就 可 以 通 
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代码 清单 13-3 ”处 理 当 前 节点 显示 逮 辑 


列 原本 显示 的 是 英文 名 称 ， 


[dl] .name}</td> 


tyMap", currentActivityMap); 


<C:forEach items="${currentActivityMaple.id]}" var="acid"> 
<c:set var="task" value="${taskMap[acid]}" /> // 根据 活动 ID 获取 Task 对 象 
<a href="${ctx }/chapterl3/process/trace/view/$ {task.executionI 
<c:if test="${task.processDefinitionId != e.processDefinition] 
<span title=' 引 用 了 外 部 流程 '> 
$s{definitions[task.processDefinitionId] .name}</span> 
/CIE 
$s{task.name} 
</a> 
<c:if test="$ {empty task.assignee}"> (<span class="text-info 
<c:if test="${not empty task.assignee}"> 
(<span class="text-info"> 办 理 中 </span>$ {task.assignee}) 
</c:if> 
</C:forEach> 


13.3 


流程 图 跟 中 


13.2.2 节 介绍 了 如 何 查 询 和 当前 用 户 相关 的 流程 实例 ， 但 是 仪 查看 当前 活动 的 节点 还 


图 形 是 最 直观 的 展示 方式 和 记忆 方式 ， 除 了 能 跟踪 刚刚 提 到 的 信息 之 外 ， 


已 经 办 理 过 ， 红 色 表 示 当 前 节点 ) ， 


过 下 面 的 代码 显示 出 来 ， 从 definitions 缓 存 对 象 中 读 取 流程 


用 代码 清单 13-3 所 示 的 代码 处 理 节点 名 称 即 可 显示 为 中 文 的 任务 名 称 ， 


dj" target=" plank">#1 <%$-- 处 理 [ 调 用 活 
[d} "> 


"> 未 签收 </span>) </c:if 


不 不 自 


qd (0)); 
EY， 以 便 获取 当前 任务 


定义 对 象 ， 名 7 大 后 获取 流程 


能 以 图 形 的 方式 展示 每 一 个 流程 中 处 于 活动 的 任务 和 已 


这 样 可 以 大 幅度 提升 用 户 体验 。 图 形 化 的 流程 跟踪 如 图 13-11 所 示 ， 其 中 “[ 部 门 /人 事 ] 联 合 会 签 " 


定义 的 名 称 ， 


即 流程 名 称 。 


并 且 可 以 显示 每 个 任务 的 办 理 人 以 及 状态 。 


么 办 理 过 的 任务 ， 以 不 同 的 颜色 对 不 同 状态 的 任务 加 以 区 分 
为 当前 节点 使 用 红色 边框 表示 。 


多 满足 需求 ， 比 如 用 户 要 跟踪 流程 办 理 的 每 一 步 的 信息 ， 再 比如 任务 何 时 创建 、 何 时 完成 、 任 务 的 办 理 人 等 信 


( 蓝 色 表示 


UK | localhost:8080/chapterl3-query/chapterl3/process/trace/view/1626 


当前 处 理 人 | Kermit Miao/kermit 


创建 时 间 2013-03-30 05:12:44 


图 13-11 图 形 化 流程 跟踪 
图 形 化 流程 跟踪 也 会 遇 到 和 13.2.2 节 处 理 当 前 节点 时 相同 的 问题 ， 需 要 根据 三 种 不 同类 型 的 数据 状态 获取 当前 活动 ID， 这 样 才能 在 展示 层 根 据 状态 用 红色 边框 标注 当前 处 于 活动 的 节点 。 
本 节 的 代码 位 于 webapp/WEB-INF/views/chapter13/trace-process.jsp 以 及 src/main/java/me/kafeitu/web/chapter13/TraceProcessController.java 中 。 
通过 代码 清单 13-3 中 #1 处 的 链接 可 以 打开 流程 跟踪 的 页 面 ， 图 13-11 中 的 URL 表 示 跟 踪 ID 为 1626 的 Execution 对 象 的 办 理 状态 。 
要 实现 图 形 化 流程 跟踪 首先 需要 读 取 流 程 的 图 片 文件 ， 在 第 5 章 中 已 经 介绍 了 如 何 根据 流程 定义 ID 读 取 图 片 资源 ， 所 以 本 节 不 再 重复 介绍 ， 读 者 可 以 参考 相关 示例 代码 。 


如 何 定位 当前 节点 在 流程 图 中 的 位 置 是 本 节 的 核心 内 容 ， 获 取 这 些 信息 需要 使 用 引擎 的 内 部 AP1， 这 样 可 以 根据 流程 定义 1D 获取 整个 流程 定义 中 所 有 活动 (Activity) 集合 ， 然 后 利用 当前 流程 中 处 于 活 


动 状态 的 活动 1D 与 流程 定义 中 的 活动 对 象 的 ID 匹配 ， 从 而 决定 红色 边框 定位 在 何 处。 


代码 清单 13-4 列 出 了 利用 内 部 API 获 取 流 程 定义 中 所 有 活动 对 象 的 代码 。 


代码 清单 13-4 利用 内 部 API 获 取 流 程 定义 中 所 有 活动 对 象 


RepositoryServiceImpl repositoryServiceImpl = (RepositoryServiceImpl) repositoryService; 
ReadonlyProcessDefinition deployedProcessDefinition = repositoryServiceImp] 
.getDeployedProcessDefinition (executionEntity.getProcessDefinitionId()); 
ProcessDefinitionEntity processDefinition = 
(ProcessDefinitionEntity) deployedProcessDefinition; 
List<ActivitylImpl> activitiList = processDefinition.getActivities (); 


代码 清单 13-4 最 终 获 取 到 了 ActivityImplI 集 合 ， 该 集合 中 的 每 一 个 对 象 都 有 一 些 了 getter 方 法 ， 例 如 getWidth0、getHeight0、getX0、getY(0) 分 别 获 取 了 宽度 、 高 度 、XY 坐 标 信息 。 当 然 也 可 以 通过 


调用 该 对 象 的 getProperties(0.get("type") 方 法 获取 每 个 活动 的 实际 类 型 ， 例 如 userTask 表 示 用 户 任务 ，startEvent 表 示 启 动 事件 等 。 


了 解 了 ActivityImpl 对 象 的 功能 之 后 就 可 以 利用 循环 的 方式 处 理 每 个 对 象 ， 根 据 活动 类 型 的 不 同 以 及 是 否 是 当前 节点 把 数据 封装 到 一 个 Map 对 象 集合 中 传递 给 展示 层 (本 例 使 用 JSON 方 式 共 展示 层 通 过 


Ajax 方式 获取 ) 。 循 环 处 理 代 码 见 代 码 清单 13-5。 


代码 清单 13-5 “循环 处 理 Activitylmp| 圭 装 响应 数据 


// 最 终 返 回 给 展示 层 的 结果 变量 
List<Map<String, Object>> activityInfos = new ArrayList<Map<String, Object>> () ， 
for (ActivityImpl activity : activitiList) { 
// 不 同 的 活动 类 型 对 应 不 同 的 Behavior 
ActivityBehavior activityBehavior = activity.getActivityBehavior () ， 
boolean currentActiviti = false; 
if (activity.getId() .equals (activityId)) { // 判断 是 否 为 当前 节点 
currentActiviti = true; 


} 
// 如 果 不 是 当前 节点 且 活动 类 型 属于 子 流 程 ， 或 者 将 调用 活动 设置 为 当前 节点 
// 这 里 为 了 展示 不 做 过 多 的 复杂 处 理 ， 读 者 可 以 在 此 基础 上 加 以 改进 
if (!currentActiviti && (activityBehavior instanceof SubProcessActivityBehavior 
| | activityBehavior instanceof CallActivityBehavior)) { 
currentActiviti = true; 


} 
Map<String, Object> activityImageInfo 

packageSingleActivitiIin 
activityInfos.add (activityImageInfo) ; 


蕊 二 
| 


Fo (activity, executionEntity, currentActiviti); 


代码 清单 13-5 最 后 调用 的 是 packageSingleActivitilnfo() 方 法 ， 用 于 根据 Activitylmpl 对 象 的 属性 设置 相关 信息 来 为 展示 层 提供 数据 。packageSingleActivitilnfo( 方 法 见 代码 清单 13-6。 


代码 清单 13-6 ”packageSingleActivitilnfo() 方 法 


private Map<String, Object> packageSingleActivitiInfo(ActivityImpl activity, 

ExecutionEntity execution, boolean currentActiviti) throws Exception { 
Map<String, Object> vars = new HashMap<String, Object>(); 
Map<String, Object> activityInfo = new HashMap<String, Object>(); 
activityInfo.put ("currentActiviti",，currentActiviti); // 设置 当前 节点 标志 
activityInfo.put ("width", activity.getWidth()); // 设置 在 图 片 中 的 宽度 
activityInfo.put ("height"，activity.getHeight()); // 设置 在 图 片 中 的 高 度 
activityInfo.put ("x"，activity.getX()); // 设置 在 图 片 中 的 Xx 坐标 
activityInfo.put ("y"，activity.getY()); // 设置 在 图 片 中 的 Y 坐 标 
Map<String, Object> properties = activity.getProperties () ， 

// 把 活动 类 型 的 英文 转换 为 中 文 
vars.put ("任务 类 型 "，ActivityUtil.getZzhActivityType (properties.get ("type") .toString() ) ) 
// 当前 节点 的 task 


if (currentActiviti) { 
Task currentTask = taskService.createTaskQuery () .executionId (execution.getId()) 
.taskDefinitionKey (execution.getActivityId() ) .singleResult (); 
if (currentTask == null) return; 
String assignee = currentTask.getAssignee (); 
if (assignee != null) { 


User assigneeUser = identityService.createUserQuery () 
.USEr] (SSL ne singleResult ()，; 
String userIinfo = assigneeUser.getFirstName() + " " + assigneeUser.getLastName () 
+ "/" + assigneeUser.getId(); 
vars .put (" 当 前 处 理 人 "，userInfo) ; 
vars .put ("创建 时 间 "，currentTask.getCreateTime () ) ; 
} else { vars.put( ("任务 状态 "， "未 签收 ");  ]} 


一 、 


activityInfo.put ("vars", vars); 
return activityInfo; 


后 台 代 码 准 备 就 绪 ， 在 展示 层 中 添加 如 下 的 代码 来 读 取 流程 图 。 


<img idq="ProcessDiagram'" src="${ctx }/chapter5/read-resource?pdid=$ {historicProcessInstance.processDefinitionId} &resourceName=$ {processDefinition.diagramResourceName}" /> 


然后 JavaScript 通 过 Ajax 请 求 获 取 JSON 数 据 循环 处 理 ， 即 可 得 到 如 图 13-12 所 示 的 效果 。 对 于 JavaScript 如 何 实现 定义 涉及 JavaScript 的 一 些 用 法 ， 这 里 不 做 详细 解释 ， 读 者 可 以 参考 本 章 源码 的 trace- 
process.js 文 件 ， 该 文件 做 了 一 个 简单 的 示例 ， 读 者 可 以 使 用 自己 熟悉 的 展示 工具 或 插件 实现 相同 功能 。 


对 [{vars: {任务 类 型 :开始 节点 }，height:35, width:35, y:38, currentActiviti:false, x:18},..] 
bP: lvars: {任务 类 型 :开始 节 反 上}，height:35, width:35, y:38, currentActiviti:false, x:18} 
TT1: {vars: {当前 处 理 作 :Kermit Miao/kermit， 创 建 时 间 :2813-83-38 85:12:44， 任 务 类 到: 用户 任务 }， 
currentAct1viti: true 
height: 55 
“Vars: {当前 处 理 人 :Kermit 人 iaokermit ， 创建 时 间 :2813-83-38@ 85:12:;44， 尾 务 类 型 :用户 任 务 } 


任务 类 型 : "用 户 任 务 " 
创建 时 则 : "2813-83-38 85:12:44" 
当 琢 处 理 人 : "Kermit Miao/kermit" 

Widthn: 185 

XX 9 

y: 2 

> 2: {vars: {任务 类 娃 : es height:55, width:185, 时 28, currentActiviti:false, x: 340} 

1Y 消 height: 33, width:33 currentActiviti:1alse 


图 13-12 ” 读 取 JSON 格 式 的 流程 跟踪 数据 


为 了 实现 图 形 化 流程 跟踪 ， 不 仅 要 编写 Java 代 码 还 需要 展示 层 的 协助 (Javascript 代 码 ) ， 有 没有 比较 简单 的 方式 呢 ? 我 们 知道 ， 如 果 在 部 署 流程 时 部 署 了 XML (扩展 名 为 bpmn 或 bpmn20.xml) 类 型 
的 文件 ， 引 警 会 使 用 ProcessDiagramGenerator 工 具 类 生成 PNG 格 式 的 图 片 作为 流程 图 ， 这 个 工具 类 人 允许 在 生成 图 片 的 时 候 用 红色 边框 标记 某 些 节点 ， 最 终生 成 的 图 片 与 图 13-11 中 的 红色 边框 一 样 可 以 标 
注 当 前 的 活动 节点 。 


代码 清单 13-7 列 出 了 控制 层 代 码 。 


代码 清单 13-7 引擎 内 置 的 图 形 化 流程 跟踪 


QRequestMapping (value = "trace/data/auto/{executionId}") 
public void readResource (@PathVariable ("executionId") String executionId， 
HttpServletResponse response) throws Exception { 
Processinstance ProcessInstance = Ce createProcessInstanceQuery () 
.DrocessInstanceId (executionId) .singleResult 
BpmnModel bpmnModel = repositoryService // 向 流 氏 定义 : [ID 获取 BpmnMogdel 
.getBpmnModel (processInstance.getProcessDefinitionId()); #1 
List<String> activeActivityIds = runtimeService.getActiveActivityIlIds (executionId); #2 
InputStream imageStream = ProcessDiagramGenerator.generateDiagram (bpmnModel, #3 
"png", activeActivityIds); 
// 输出 资源 内 容 到 相应 对 象 


byte e[] b = new byte[1024]; 
int len; 
while ((len = imageStream.read(b, 0, 1024)) != -1) { 


response.getOutputSstream() .write(b, 0, len); 
} 


首先 查询 流程 实例 对 象 获 取 流 程 定义 ID， 然 后 在 #1 处 获取 一 个 BpmnModel 对 象 (封装 了 流程 文件 中 的 所 有 Activity 对 象 ) ， 在 #2 处 查询 当前 Execution 对 象 的 所 有 处 于 活动 状态 的 Activity 1D 和 集合， 把 
这 个 集合 用 #3 处 的 ProcessDiagramGenerator 工 具 类 生成 图 片 文件 流 对 象 。 


在 代码 清单 13-7 中 ，#3 处 的 代码 在 Activiti 5.16 版 本 不 在 适用 ， 从 该 版 本 开始 把 图 片 生成 功能 提取 为 一 个 独立 的 模块 (activiti-image-generator) ，ProcessDiagramGenerator 类 也 从 class 转 换 为 
interface， 原 来 的 ProcessDiagramGenerator 类 被 重新 包装 命名 为 DefaultProcessDiagramGenerator 作 为 引擎 默认 的 图 片 生成 器 ， 这 样 的 改变 允许 我 们 自 定义 自己 的 流程 图 生成 器 并 注入 引擎 中 。 自 定义 
的 流程 图 生成 器 实现 ProcessDiagram-Generator 接 口 并 在 引擎 配置 对 象 中 设置 “processDiagramGenerator” 属 性 ， 相 关 配 置 如 下 : 


<bean id="processEngineConfiguration" class="org.activiti .xxx.XxxProcess-EngineConfiguration"> 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15030/0EBPS/Text/... 
<property name="processDiagramGenerator"> 
<bean class="me.kafeitu.activiti. 
chapter13.MyProcessDiagramGenerator" /> 


</property> 
</bean> 


最 后 在 展示 层 读 取 图 片 流 即 可 看 到 如 图 13-13 所 示 的 流程 图 ， 代 码 如 下 : 


<img id="processDiagramAuto" src="${ctx } /chapter13/Process/ 
trace/data/auto/ 
${historicProcessInstance.processInstanceId}" /> 


| 急 [ 部 门 /人 事 ] 
联合 会 答 
|| 


图 13-13 ”使 用 引擎 提供 的 工具 类 生成 的 流程 图 并 标注 了 当前 节点 


如 果 使 用 引 警 默认 的 配置 ， 在 Windows 和 Linux 平 台 下 引擎 自动 生成 的 图 片 会 有 中 文 乱码 问题 ， 也 就 是 第 5 章 中 介绍 的 那样 ， 只 能 通过 修改 字体 文件 的 方式 解决 这 个 问题 。 从 Activiti 5.12 版 本 开始 彻底 
解决 了 这 个 问题 ， 引 警 允 许 通过 配置 的 方式 设置 生成 流程 图 时 使 用 的 字体 ， 在 引擎 中 添加 如 下 的 配置 即 可 解决 乱码 问题 。 


<property name="activityFontName" value=" 宋 体 " /> 


虽然 使 用 引擎 提供 的 方式 可 以 很 容易 获取 到 标记 了 活动 节点 的 流程 图 ， 但 是 这 种 方式 也 有 不 足 之 处 : 
. 未 使 用 原 流程 文件 中 的 坐标 信息 定位 活动 。 
. Flow 上 的 文字 未 显示 (因为 不 同 设 计 器 的 Flow 文 字 的 坐标 算法 不 同时 致 错位 或 不 显示 ， 未 来 版 本 会 修复 ) 。 


. 展示 层 很 难 在 此 基础 上 扩展 功能 ， 因 为 坐标 信息 与 ActivityImpl 对 象 中 的 不 同 。 


13.4 ”历史 数据 查询 
历史 数据 查询 是 相对 于 运行 时 数据 来 说 的 ， 查 询 方 式 与 之 类 似 ， 可 以 使 用 标准 查询 ， 也 可 以 使 用 Native 查 询 。 本 章 开 头 的 图 13-2、 图 13-3 中 以 “Historic” 开头 的 查询 对 象 都 属于 历史 数据 范畴 。 


13.4.1 ”查询 历史 活动 及 表单 


13.3 节 用 图 形 方式 直观 地 展示 了 当前 流程 的 活动 节点 ， 如 果 此 时 用 户 需 要 查询 该 流程 的 办 理 过 程 ， 例 如 哪个 节点 由 谁 办 理 或 者 相关 的 变量 等 信息 时 就 需要 通过 HistoryService 接 口 查询 ， 在 图 13-11 的 页 
面 中 再 添加 图 13-14 中 三 个 表格 的 历史 数据 就 可 以 满足 需求 了 。 图 13-14 中 的 历史 数据 包含 了 流程 综合 信息 (HistoricProcesslnstance) 、 活 动 记录 (HistoricActivitylnstance) 、 相 关 变 量 
(HistoricVariablelnstance) ， 对 应 的 API 调 用 可 以 参考 代码 清单 13-8。 


流程 ID 1760 流程 定 忱 ID purchase-subprocess:2:1316 业务 KEY 

流程 启动 时 间 。 2013-03-30 09:30:08 流程 结束 时 间 流程 状态 未 结束 
活动 ID 活动 名 称 活动 类 型 性 务 ID 办 理 人 活动 开始 时 间 活动 结束 时 间 活动 耗 时 (种) 
1763 starteventi1 startEvent 2013-03-40 O09:30:08 2013-03-40 09:30:08 QQ.0 

1770 | 额 导 审 批 Userlask 177 kermt 2013-03-30 09:30:08 2013-04-30 09:30:29 20.78 

1775 | Exclusive Gateway exclusiveGateway 2013-03-30 O930-29 2013-03-30 09:30:29 总. 

1776 | 联系 供 货 方 UserTask i7i? thomas 2013-03-30 09:30:29 2013-03-40 09:31:13 43.976 

1790 | 付费 子 流程 suUbProcess 2013-03-30 QQ9:31:13 QO 

1791 ， 峙 务 审批 aarTask. 1792. 2n13-03-3nL0n9:314:1 及 Nn. 
相关 变量 

变量 名 称 变量 类 型 值 

applyUserld string kermit 

dueDate date Fri Apr 05 00:00:00 GST 2013 

iisting rn ww 

amountMoney double Jd2342.0 

deptLeaderApproved string true 

supplier string 苹果 公司 

bankName string 中 国 工商 银行 


图 13-14 ”历史 相关 数据 
代码 清单 13-8 ”查询 历史 活动 及 表单 数据 


// 查询 所 有 的 历史 活动 记录 


jst<HistoricActivityInstance> activityInstances = historyService 


.1ist(); 


.CreateHistoricActivityInstanceQuery() .processIinstanceld (ProcessInstanceId) 
// 查询 历史 流程 实例 
HistoricProcessInstance historicProcessInstance = historyService 
.CreateHistoricProcessInstanceQuery () .processInstanceId (DrocessInstanceId) .singleResult () ， 
// 碍 询 流 程 有 关 的 变量 
List<HistoricVariableInstance> VariableInstances = historyService 
.CreateHistoricVariableInstanceQuery() .ProcessInstanceId (ProcessInstanceId) .list ()，; 


需要 特别 说 明 的 是 ， 如 果 查 询 了 HistoricActivitylnstance 类 型 的 数据 ， 就 没有 必要 再 查询 HistoricTasklnstance， 因 为 前 者 包含 了 后 者 ， 图 13-14 中 第 二 个 表格 的 “活动 类 型 ” 值 为 “userTask” 的 数据 
即 表示 一 个 用 户 任务 的 办 理 过 程 ，“ 任 务 ID” 列 也 显示 了 相关 任务 的 1D。 


另外 ， 如 果 要 查询 任务 表单 产生 的 数据 需要 查询 HistoricDetail 对 象 ， 通 过 下 面 的 代码 可 以 只 查询 与 流程 相关 的 表单 属性 ， 结 果 如 图 13-15 所 示 。 查 询 到 的 结果 的 实际 类 型 为 
org.activitengine.history.HistoricFormProperty， 可 以 通过 getPropertyld0 和 getPropertyValue(0 获 取 表 单 属 性 的 名 称 与 值 。 


List<HistoricDetail> formProperties = historyService 
.CreateHistoricDetailQuery() .formProperties () .List()， 


amountvyioney 


listing 


dueDate 
deptLeaderAporoved 
planDate 

bankName 

suUpplier 


bankAccount 


13.4.2 ”查询 已 归档 流程 


图 13-16 展 示 了 “已 归档 ”列表 ， 也 就 是 已 经 结束 的 流程 实例 ， 


属性 值 尾 务 ID 设置 时 间 

We a 013-0d=30 QU 
sdhwfw 2013-04-30 09:30:08 
2013-04-05 2013-04-30 09:30:08 
trua 全 二 二 -二 09:30:29 
2014-04-05 2013=04=340 09:31:13 
中 国 工商 银行 2013-09-30 09:31:19 
苹果 公司 2013-0=30 09:31:1y 
622232947927342 2013-09-30 09:31:13 


图 13-15 ”流程 相关 表单 属性 


可 以 看 到 列表 中 显示 了 流程 的 启动 、 结 束 时 间 以 及 流程 启动 人 等 信息 ， 如 果 该 流程 是 由 其 他 流程 派生 的 ， 则 显示 “ 父 流程 ID” 属性 值 。 


Activiti Explorer 会 首 页 。 器 请 假 {普通 表单 ) ~ ; 瞪 已 归档 。 器 管理 ~ 上 上 Kermit Miao/karmit™ 


流程 实例 ID 所属 流程 


办 和 公用 品 采 购 
办 公用 品 采 购 --Callactivlty 方 式 
通用 付款 流程 
办 公用 品 采购 


流程 定 交 ID 启动 时 间 流程 局 动人 结束 时 间 父 流程 ID 


Burchase-subprocess:1:10 2013-03-14 OF7:52:11 ( kerrmit 2013-04-03 10:01:29 


burchase-callactivity.2.:1314 5 2013-03-30 U8.25.38 thomas 2013-04-03 10.03.32 


payment:2:1315 2013-03-30 08:40:10 thomas 2013-04-03 10:00:55 | 1722 
purchnase-SuDprocess:e:1316 2013-03-30 09:30,08 Kermit 2013-04-03 10:03:06 


共 4 条 数据 << 


图 13-16 ”已 归档 的 流程 实例 


单 击 流程 实例 ID 可 以 打开 图 13-14 所 示 的 页 面 ， 可 以 查看 该 流程 办 理 过 程 中 产生 的 历史 记录 。 代 码 清单 13-9 列 出 了 查询 该 列表 的 代码 ， 并 启用 了 分 页 查询 。 


代码 清单 13-9 ”查询 已 归档 流程 实例 


QRequestMapping (value = "finished/list") 
public ModelAndView finishedqProcessInstanceList (HttpServletRequest request) { 


ModelAndView mav = new ModelAndView ("chapter13/ 


Page<HistoricProcessInstance> page = new 


Page<HistoricProcessInstance> (PageUtil] .PAGE | 


finished-process"); 


SIZE); 


int[] pageParams = PageUtil.init (page, request); 


HistoricProcessInstanceQuery hi 


storicProcessInstanceQ 


.CreateHistoricProcessInstanceQuery () .finished(); 


uery = historyService 


// 只 查询 已 经 结束 的 数据 


List<HistoricProcessInstance> historicProcessInstances = historicProcessInstanceQuery 
.listPage (pageParams[0], pageParams [1]); 


// 查询 流程 定义 对 象 


Map<String, ProcessDefinition> 


definitionMap = new HashMap<String, ProcessDefinition>(); 


for (HistoricProcessInstance historicProcessInstance : 


definitionCache (definitionMap, historicProcess] 


page.setResult (historicProcess] 


[Instances); 


page.setTotalCount (historicProcessInstanceQuery.count 


mav.addobject ("page", page); 


mav.addobject ("definitions", definitionMap); 


return mav; 


historicProcessInstances) { 


[nstance.getProcessDefinitionId()); 


() ); // 统计 总 数 


13.5 ”基于 MyBatis 的 CustomSq|l 查 询 


标准 查询 与 Native 查 询 各 有 优势 ， 前 者 允许 以 链 式 编程 的 方式 查询 数据 ， 而 Native 查 询 方式 可 以 自由 地 拼接 SQL 语 句 组 合 查询 。 


对 于 简单 查询 来 说 ， 这 两 种 查询 基本 能 满足 需求 ， 但 是 对 于 稍微 复杂 一 点 的 需求 就 难以 胜任 了 ， 例 如 查询 当前 正在 运行 的 任务 并 根据 流程 定义 名 称 进行 过 滤 ， 显 示 的 字段 如 图 13-17 所 示 。 


和 售 怠 国 localhost 8080/chapterl3-query/main/index# 


Activiti Explor er 前 首 页 se 表 假 《普通 表单 } ~ ma 运行 中 一 曲 已 归档 ss 管理 = 旦 Kermit Miao/kermit 


| ke 二 1 
流程 名 称 : | 宝 部 | 站 查询 广 程 定 广 


任务 ID 任务 名 称 办 理 人 “ 流程 实例 ID | 流程 名 称 流程 定义 ID 创建 时 间 
1640 [部 门 / 人 事 ] 联 言 会 莹 andhy 1601 请 假 流程 -会 得 leave-countersign:1:1319 Sat Mar 30 17:12:44 CST 2013 
1649 | [部 门 / 人 事 ] 联 合 会 签 henry | 1601 请 假 流 程 -会 签 leave-Ccountersign:1:1319 Sat Mar 30 17:12:44 CST 2013 


图 13-17 运行 中 任务 列表 


图 13-17 除 了 包含 任务 的 主要 属性 外 还 包含 “流程 名 称 ”字段 ， 如 果 使 用 标准 查询 ， 需 要 先 查 询 相关 任务 再 查询 与 任务 相关 联 的 流程 定义 来 获取 “流程 名 称 ”属性 。 使 用 Native 碍 询 虽 然 可 以 编写 SQL 语 
句 来 关联 查询 ， 但 是 Native 查 询 只 能 返回 引擎 的 儿 个 固定 对 象 ， 也 就 是 返回 结果 不 能 自 定义 。 
为 了 解决 查询 的 灵活 性 问题 ， 从 Activiti 5.15 版 本 开始 添加 了 基于 MyBatis 的 查询 接口 ， 允 许 开 发 人 员 使 用 MyBatis 的 语法 查询 数据 ， 并 且 查询 结果 的 类 型 很 灵活 ， 该 功能 被 封装 在 


ManagementsService 接 口 的 executeCustomsq| 方 法 中 。 


图 13-18 列 出 了 executeCustomSql| 的 APl， 从 中 可 以 看 出 该 方法 接收 一 个 类 型 为 CustomSqlExecution 的 参数 ， 并 且 需 要 泛 型 <MapperType，ResultType> : MapperType 表 示 定 义 MyBatis 语 法 查询 
的 接口 类 型 ，ResultType 表 示 返 回 结 果 的 类 型 。 代 码 清单 13-10 列 出 了 查询 图 13-17 中 列表 的 相关 代码 ， 从 代码 中 可 以 看 出 CustomSqlExecution 接 口 泛 型 为 
<TaskQueryMapper, List<RunningTask>>。 


<MapperType ReasultTyYpe> executeCustomSgl (CustomSqlExecution<MapperType,ResultType> customSqlExecution) 


ResultType [EXPERIMENTAL] Executes the sql contained in the CustomSqlExecution parameter. 


图 13-18 ManagementService 的 executeCustomSqgl 方 法 API 


代码 清单 13-10 ”使 用 CustomSql 查 询 运 行 中 任务 


CustomSgqlExecution<TaskQueryMapper, List<RunningTask>> customSgqlExecution = 
new AbstractCustomSgqlExecution<TaskQueryMapper, 
List<RunningTask>> (TaskQueryMapper.class) { 
public List<RunningTask> execute (TaskQueryMapper customMapper) { 
List<Map<String, Object>> maps = null; 
if (StringUtils.isBlank (processKey)) { 
maps = customMapper.selectRunningTasks () ; 
} else { 
maps = customMapper.selectRunningTasksByProcessKey (processKey); 


} 
List<RunningTask> tasks = packageTasks (maps); 
return tasks; 


} 


List<RunningTask> tasks = managementService.executeCustomSql (customSqlExecution); 


13.5.1 定义 Mapper 接 口 


使 用 MyBatis 查 询 数 据 需要 我 们 定义 一 个 Mapper 接 口 ， 例 如 代码 清单 13-10 中 的 TaskQueryMapper 接 口 ， 在 接口 中 用 @select 注 解 声明 方法 执行 时 需要 查询 的 SQL， 如 代码 清单 13-11 列 出 了 
TaskQueryMapper 的 SQL 定义 。 


代码 清单 13-11 TaskQueryMapper 接 口 定义 


public interface TaskQueryMapper { 
@Select ("select art.ID , art.NAME, , art.ASSIGNEE , art.CREATE TIM 由 区 


和 - 时 FE， 
" art.PROC INST ID , art.PROC DEF ID , arp.NAME PROCESS NAME" 


" from ACT RU TASK art" 十 


"inner join ACT RE PROCDEF arp on art.PROC DER ID = arp.ID " 
" where arp.SUSPENSION STATE = '1'") 和 本 
GQResults (value = { 
QResult (id = true, Droperty = "id", column = "ID ™, 
javaType = String.class, jdbcType = JdbcType.VARCHAR), 
// 省 略 了 其 他 字段 


} ) 
List< RunningTask> selectRunningTasks () ; 


} 


从 代码 清单 13-11 中 的 SQL 可 以 看 出 ， 任 务 表 (ACT_RU_TASK) 与 流程 定义 表 (ACT_RE_PROCDEF) 使 用 了 内 关联 ， 查 询 的 结果 集中 既 包 含 任务 表 的 字段 又 包 含 流程 定义 表 的 字段 ， 用 MyBatis 的 
@ Result 注 解 声 明了 查询 结果 中 字段 与 RunningTask 对 象 属性 的 映射 关系 ， 最 终 会 返回 一 个 RunningTask 集 合 。 


如 果 不 封装 成 对 象 也 可 以 直接 返回 一 个 Map 类 型 的 集合 ， 例 如 下 面 的 配置 : 
List<Map<String, Object>> selectRunningTasks () ， 


熟悉 MyBatis 的 读者 还 可 以 再 使 用 其 他 注解 查询 结果 ， 例 如 在 SQL 中 使 用 MyBatis 的 判断 语句 (if) 等 。 


RunningTask 对 象 的 属性 见 下 面 的 代码 : 


public class RunningTask { 


private String id; 

private String name; 

private String assignee; 

private String processName; 
private String processInstancelgd; 


private String processDefinitionIg; 
private Date createTime; 
// 省 略 getter 和 setter 


除了 自 定义 Bean 对 象 外 还 可 以 使 用 引擎 的 内 部 实体 对 象 ， 例 如 下 面 的 代码 返回 一 个 TaskEntity (引擎 内 部 类 org.activiti.engine.impl.persistence.entity.TaskEntity) 对 象 集合 : 


QSelect ("select * from ACT RU TASK RES" + 
" inner join ACT RU VARIABLE VAR on 
VAR.PROC INST ID = RES.PROC INST ID " 十 
" where VAR.NAME = #{variableName}") 
List<TaskEntity> findTasks (String variableName); 


13.5.2 ”展示 数据 


准备 好 了 Mapper 对 象 以 及 查询 结果 Bean 对 象 RunningTask， 现 在 我 们 需要 把 结果 展示 出 来 ， 相 关 代 码 见 代码 清单 13-12 所 示 ， 对 应 的 JSP 文 件 位 于 chapter13/src/main/resources/WEB- 
INF/views/chapter13/running-tasks.jsp。 


代码 清单 13-12 MapperQueryController 控 制 器 


public class MapperQueryController { 
QRequestMapping (value = "task/running") 
public ModelAndView list( 
QRequestParam(value = "processKey", required = false) final String processKey) 1 
ModelAndView mav = new ModelAndView ("chapterl13/running-tasks"); 
// 此 处 引用 代码 清单 13-11 
// 省 略 了 把 结果 对 象 封装 到 ModelaAndqView 的 相关 代码 


13.6 本章 小 结 


本 章 的 重点 只 有 一 个 一 一 查询 ， 从 分 析 引 擎 的 查询 API 开 始 ， 然 后 分 别 讲解 了 如 何 使 用 标准 查询 、Native 查 询 以 及 基于 MyBatis 完 全 自 定 义 的 查询 方式 。 


三 种 类 型 的 查询 有 着 各 自 的 特点 ， 标 准 查询 允许 以 链 式 编程 的 方式 查询 数据 ，Native 查 询 可 以 自由 地 拼接 SQL 语句 组 合 查询 ， 但 是 返回 的 结果 类 型 都 是 引擎 预先 映射 到 MyBatis 的 ; Customsq| 查 询 最 
灵活 ， 不 仅 SQL 语 句 自己 拼接 ， 并 且 碍 询 的 结果 类 型 也 可 以 自 定义 。 


= 1 
第 14 章 ”管理 员 特 性 
几乎 在 每 个 系统 中 都 会 有 一 个 监管 整个 系统 的 后 台 模块 ， 根 据 功能 的 不 同 分 配给 超级 管理 员 或 者 普通 管理 员 。 在 工作 流 驱 动 的 业务 系统 中 管理 员 特性 一 般 包 含 如 下 几 个 特性 ， 本 章 的 内 容 也 围绕 这 几 个 
寺 性 一 一 介绍 ， 


. 用 户 与 组 的 管理 : 一 般 的 系统 中 都 配 有 统一 的 用 户 模块 ， 本 章 仅 讨论 与 Activiti 相 关 的 内 容 。 


. 作业 管理 : 可 以 监管 定时 或 异步 的 作业 任务 。 


"数据库: 可 以 直接 通过 系统 查看 数据 库 的 记录 。 


14.1 流程 状态 


假设 这 样 一 个 场景 : 一 个 正在 运行 的 流程 实例 由 于 某 些 原因 要 暂停 ， 从 技术 上 来 说 就 是 “ 挂 起 ”， 当 条 件 满足 之 后 再 恢复 状态 继续 运行 该 流程 实例 。 

在 Activiti 中 ， 这 一 过 程 有 两 个 对 应 的 操作 : 挂 起 (suspend) 、 激 活 (active) 。 除 了 控制 流程 实例 外 还 可 以 控制 流程 定义 〈ProcessDefinition) 的 状态 ( 挂 起 或 激活 ) ， 并 且 可 以 选择 是 否 激活 与 流 
程 定义 相关 的 流程 实例 ， 以 及 定时 激活 或 挂 起 。 
14.1.1 流程 定义 状态 

在 第 5 章 中 介绍 了 如 何 读 取 流 程 定义 列表 以 及 如 何 删除 流程 定义 ， 目 前 的 情况 是 启动 流程 需要 先 从 “流程 定义 ”页 面 选择 一 个 流程 ， 并 且 还 执行 删除 操作 。 很 明显 这 个 “不 受 ” 的 设计 需要 改进 ， 流 程 的 
部 署 以 及 删除 属于 管理 员 的 权限 范围 之 内 ， 所 以 这 两 个 操作 对 普通 用 户 是 不 可 见 的 。 


为 此 再 添加 一 个 页 面 供 普 通用 户 使 用 ， 只 有 一 个 “启动 ”操作 ， 并 把 原来 的 “流程 定义 ”更 名 为 “流程 定义 管理 ”， 开 放流 程 部 署 及 删除 功能 ， 图 14-1 展 示 了 新 的 菜单 项 。 


汪 流程 列 未 


图 14-1 改进 的 流程 列表 菜单 


新 添加 的 “流程 列表 ”菜单 项 的 链接 如 下 : 


<li><a href="#" rel='chapter5/process-list?readonly=true'> 
流程 列表 </a></1i> 


添加 一 个 参数 “readonly” 并 设置 为 “true”， 然 后 页 面 会 根据 该 参数 控制 流程 部 署 、 删 除 功 能 是 否 可 见 (这 里 为 了 演示 简化 安全 控制 ， 在 实际 使 用 中 可 以 使 用 安全 框架 辅助 处 理 ) 。 


图 14-2 展 示 了 新 添加 的 “流程 列表 ”菜单 项 的 页 面 ， 从 图 中 可 以 看 到 原来 的 流程 部 署 区 域 与 删除 按钮 已 经 隐 茂 了， 这样 普通 用 户 可 操作 的 就 只 有 查看 流程 图 和 启动 流程 。 


Activiti Explorer 会 首页 ”时 请 假 (普通 表单 ) ~ 器 运行 中 前 已 归档 上 踢 流 程 列表 器 管理 ~ 星 Kermit Miao/kermit 


流程 定义 ID 流程 定义 名 称 流程 定义 KEY 流程 描述 图 片 资源 名 称 操作 
leave- 请 假 流 程 -会 签 laave- 请 假 流 程 演示 -会 签 E leave- 
countersign:1:19 countersign countersign.png 


leave-mail- 请 假 流 程 -邮件 任务 -销假 ”leave-mail- 请 假 流 程 - 邮 件 任 务 -销假 leave-mail- 
timeout:1:18 超时 提醒 timeout 超时 提醒 timeout.png 


> 启动 


je 启动 


图 14-2 ”流程 列表 界面 
在 “流程 定义 管理 ”界面 中 则 显示 如 图 14-3 所 示 的 操作 按钮 ， 在 该 界面 可 以 删除 和 挂 起 流程 定义 ( 挂 起 后 显示 “激活 ”操作 按钮 ) 。 


在 点 击 图 14-3 中 的 “ 挂 起 ”按钮 后 会 弹出 如 图 14-4 所 示 的 对 话 框 ， 可 以 选择 现在 挂 起 还 是 定时 挂 起 ，“ 同 时 挂 起 所 有 与 流程 定义 相关 的 流程 实例 ? ”的 含义 是 : 如 果 要 挂 起 的 流程 定义 已 经 有 正在 运行 
的 流程 实例 ， 则 同时 级 联 执行 挂 起 操作 。 


图 片 资 源 名 称 


Bave-coUnNtersign.ong 


lBave-imall-timeout.onNg 


图 14-3 ”流程 定义 管理 界面 的 操作 按钮 


往 起 流程 定 Y% 


何 时 执行 ， 


图 同时 挂 起 所 有 与 流程 定 兴 相关 的 流程 实例 ? 


图 14-4” 挂 起 流程 定义 对 话 框 


定时 挂 起 是 在 某 个 特定 的 时 间 挂 起 ， 利 用 引擎 内 置 的 作业 (Job) 模块 来 实现 。 在 引擎 配置 中 设置 如 下 参数 即 可 开启 Job 功 能 。 


<property name="jobExecutorActivate" value="true" /> 
开启 了 Job 功 能 之 后 引擎 默认 以 5 秒 为 间隔 轮 询 检 查 是 否 有 需要 处 理 的 Job， 如 果 作 业 的 日 期 小 于 等 于 系统 当前 时 间 ， 则 执行 该 作业 ， 详 细 内 容 会 在 14.4 节 介绍 。 
在 单 击 图 14-4 中 的 “确认 挂 起 ”按钮 后 提交 表单 ， 执 行 代码 清单 14-1 的 代码 ， 根 据 状态 的 不 同调 用 RepositoryService 接 口 的 不 同方 法 。 


代码 清单 14-1 ”更改 流程 定义 状态 


QController 
QRequestMapping (value = "/chapter14/process") 
public class ProcessManagerController { 
QRequestMapping (value = "{state}", method = RequestMethod.POST) 
public String changeState (GPathVariable (value = "state") String state, 
QRequestParam(value = "processDefinitionId") String processDefinitionIg, 
QRequestParam(value = "cascade", required = false) boolean cascadeProcessInstances, 
QRequestParam(value = "effectiveDate", required = false) Date effectiveDate) ({ 
stringUtils.equals ("active"，state)) { // 激活 
repositoryService.activateProcessDefinitionByld (processDefinitionIg, #1 
ffectiveDate); 


3 


一 


CascadeProcessInstances, e 
} else :if (StringUtils.equals ("suspend",， state)) { // 挂 起 
repositoryService.suspendProcessDefinitionById (processDefinitionId, #2 
CascadeProcessInstances, effectiveDate); 


return "redirect:/chapter5/process-list"; 
} 
} 


代码 清单 14-1 中 的 #1 与 #2 处 分 别处 理 了 激活 与 挂 起 操作 ， 两 个 方法 有 相同 的 参数 ， 第 一 个 参数 为 流程 定义 ID， 第 二 个 参数 对 应 图 14-4 中 的 “同时 挂 起 所 有 与 流程 定义 相关 的 流程 实例 ?” 选 项 ， 最 后 
一 个 参数 表示 执行 操作 的 日 期 ， 如 果 设 置 为 null， 表 示 现 在 挂 起 ， 否 则 创建 一 个 Job 定 时 执行 。 


除了 通过 代码 清单 14-1 的 方式 激活 、 挂 起 流程 定义 之 外 ， 还 可 以 通过 流程 的 (流程 文件 中 process 标 签 的 id 属 性 ， 即 图 14-2 中 的 “流程 定义 KEY”) ID 批量 更 改 状态 。 相 关 API 如 图 14-5 所 示 。 


图 14-6 展 示 了 改进 的 流程 定义 列表 ， 其 中 “状态 ” 列 显示 了 该 流程 定义 对 象 的 状态 ( 挂 起 、 正 常 ) 。 如 果 一 个 流程 定义 被 挂 起 ， 此 流程 定义 应 该 对 普通 用 户 不 可 见 ， 所 以 需要 对 图 14-2 的 列表 数据 过 
滤 ， 即 仪 查询 处 于 激活 状态 的 数据 。 


activateProcessDefinitionBvyId(String processDefinitionId) 
Activates the process definition with the given id. 
activateProcessDefinitionById(String processDefinitionId, 
boolean activateProcessInstances, Date activationDate) 
Activates the process definition with the given id. 


activateProcessDefinitionByKey(String processDefinitionKey) 
Activates the process definition with the given key (=id in the bpmn20.xml file). 
activateProcessDefinitionBvyKey(String processDefinitionKey, 
boolean activateProcessInstances, Date activationDate) 


Activates the process definition with the given key (=id in the bpmn20.xml file). 
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图 14-5 ”激活 流程 定义 的 API 


流程 描述 
请 假 汽 程 演示 - 倪 
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tActiyiti 实 战 》 
第 6 章 的 倒 子 -- 外 : 
置 表单 


请 假 汶 程 - 邮 尾 任 
务 -销假 招 时 提 鼎 


请 假 流程 演示 地 
件 性 务 


请 乙 汶 程 演示 
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XML 资 天 名 称 


隔 昌 We= 


countersign.bpmmn 


chaptereleave- 
formkey/leave- 
formkey.bpmn 


laave=rmail- 
tmecsut, bpmn 


leave-mall.bpomn 


laava.bpmmn 


图 14-6 ”包含 挂 起 与 正常 状态 的 流程 定义 列表 


图 片 资源 名 称 
加 避 wEB- 
countersign.png 


chaptere/eave- 
formkey/leave- 
formkey.png 


eave-mall- 
timeocut.png 


leave-mall.png 


eave.png 


下 面 的 代码 在 查询 流程 定义 时 根据 readonly 的 值 进 行 了 过 滤 ， 当 然 也 可 以 只 查询 挂 起 的 流程 定义 对 象 ， 刷 新 图 14-2 页 面 后 可 以 看 到 图 14-7 所 示 的 界面 ， 比 图 14-6 的 数据 少 了 两 条 。 


processDefinitionQOuery.active(); 


// processDefinitionQuery.suspended() 只 查询 提 


起 的 数据 


流程 定 交 ID 


部 署 ID 流程 定 兴 名 称 


leave-mall-timeout:1:929 301 


leave-mall:1:924d 


laave:1:928 


payment:1:926 
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purchase-callactivity:1:923 | 901 


14.1.2 ”作业 查询 


上 一 小 节 中 提 到 了 定时 执行 挂 起 、 激 活 流程 定义 的 功能 ， 


请 假 流程 -邮件 任务 -销假 超时 提醒 


请 假 流程 -邮件 任务 
请 假 流 程 -普通 表单 
通用 付款 流程 


办 公用 品 采 购 --callactivity 方 式 


本 小 节 将 简单 介绍 一 下 如 何 查询 作业 ， 在 14.4 节 中 再 介绍 其 他 与 作业 相关 的 功能 。 


流程 定 光 KEY 


leave-mall-timeout 


leBave-mall 


leave 


payment 


流程 抄 述 
请 慨 流 程 -邮件 任务 -销假 超时 提醒 


请 假 流 程 演示 -邮件 任务 
请 假 流程 演示 


purchase-callactivity 


图 14-7 ”过滤 了 挂 起 的 流程 定义 数据 


图 14-8 展 示 了 “激活 流程 定义 ”的 对 话 框 ， 单 击 “ 确 定 激 活 ” 后 调用 引擎 接口 添加 一 个 定时 作业 ， 通 过 引擎 提供 的 接口 可 以 查询 到 如 图 14-9 所 示 的 数据 。 


激活 流程 定义 


2013-04-07 06:02:49 “| 画 


图 同时 挂 起 所 有 与 流程 定义 相关 的 流程 实例 ? 


图 14-8 激活 流程 定义 对 话 框 


作业 管理 列表 


作业 可 重 试 次 流程 实例 执行 异常 消 


流程 定 光 ID ID ID 息 
laave-formkey:1:10125 


1D 作业 类 型 | 预定 时 间 数 
12601 挂 起 流程 2014-04-16 3 


定义 09:25:56 


12606 中 间 定 时 | 2014-04-16 
09:26:13 


jiaBExecuteFail:1l:10134 | 12802 12605 


共 2 条 数据 | << 


图 14-9 ”作业 (Job) 管理 列表 


图 14-9 的 列表 列 出 了 Job 对 象 的 几 个 主要 属性 ， 根 据 “ 作 业 类 型 ”的 不 同 ， 某 些 字段 的 值 也 不 尽 相同 ， 第 一 条 记录 类 型 为 “激活 流程 定义 ” 


作业 配置 信息 操作 


finceludeProcesslnstances :trUe] 


timerintermediatecatcheventl1 


， 该 作业 只 记录 需要 启动 的 流程 定义 ID 即 可 ， 所 以 “流程 实 


例 ID”、“ 执 行 ID” 的 值 为 空 ， 只 有 运行 时 流程 产生 的 作业 才 会 有 这 两 个 值 ;第 二 条 记录 的 “作业 类 型 ”为 “中 间 定 时 ”， 我 们 知道 中 间 定 时 事件 必须 由 运行 中 的 流程 触发 ， 所 以 流程 实例 1D 与 执行 ID 均 有 


值 。 


最 后 一 个 属性 “作业 配置 信息 ”是 执行 任务 时 的 参数 ( 纯 文本 类 型 )， 例 如 第 一 条 记录 中 的 “includeProcessinstances: true” 用 JSON 格 式 保存 表示 在 执行 激活 流程 定义 时 同时 激活 流程 相关 的 实 


例 ; 而 第 二 条 记录 的 “timerintermediatecatchevent1” 是 流程 定义 中 中 间 定 时 事件 的 ID。 


下 面 的 代码 列 出 了 查询 作业 列表 的 代码 片段 ， 完 整 的 代码 请 参考 本 书 配套 资源 中 本 章 源 码 的 JobControllerjava 和 job-listjsp 文 件 。 


JobQuery jobQuery = manadgementService .createJobQuery () ; 
List<Job> jobList = jobQuery.1ist(); 


下 面 的 代码 列 出 了 展示 层 显示 属性 值 的 代码 : 


人 


td>${job.id}</td> 

td>${JOB TYPES[job.jobHandlerType]}</tqd> 
td><fmt:formatDate value="${job.duedate}" 
pattern="yyyy-MM-dd hh:mm:ss"/></tqd> 
td>$ {job.retries}</td> 
td>${job.processDefinitionId}</tqd> 


人 


人 


< 

过 
<td>Ss{job.processInstanceId}j</td> 
<td>${job.executionId}</tqd> 

< 
< 


td>${job.exceptionMessage}</td> 
td>${job.jobHandlerConfiguration}</td> 


对 于 “作业 类 型 ”属性 ，Job 对 象 显 示 的 是 英文 。 下 面 的 代码 列 出 了 目前 引擎 中 与 作业 类 型 有 关 的 中 英文 对 照 。 


JOB TYPES.put ("activate-processdefinition",， "激活 流程 定义 "); 
JOB TYPES.put ("timer-intermediate-transition", "中 间 定 时 ")， 
JOB TYPES.put ("timer-transition"，" 边 界定 时 ")，; 
t( 
t( 


JUOB TYPES .put ("timer-start-event",，" 定 时 启动 流程 ") 
JOB TYPES.put 


"suspendq-processqefinition"，" 挂 起 流程 定义 ") ， 


14.1.3 ”流程 实例 状态 


在 挂 起 、 激 活 流程 定义 时 可 以 选择 同时 级 联 更 改 相关 流程 实例 的 状态 ， 当 然 也 可 以 单独 对 流程 实例 进行 操作 ， 两 者 操作 的 API 类 似 ， 只 不 过 流程 实例 不 能 像 流程 定义 那样 可 以 定时 执行 挂 起 、 激 活 操作 。 


图 14-10 中 的 流程 实例 列表 中 列 出 了 流程 实例 ， 并 且 包含 了 正常 和 挂 起 两 种 状态 的 数据 。 


通过 调用 下 面 两 个 RuntimesService 接 口 的 方法 可 以 分 别 激活 、 挂 起 流程 实例 ， 这 两 个 方法 均 有 一 个 流程 实例 ID 参数 。 


void activateProcessInstanceById (String ProcessInstanceId) 
void suspendProcessInstanceBylId(String ProcessInstanceId) 


Explorer ”前 普 页 ”器 请 由 (普通 表单 ) ~ 和 当 。 疆 流 程 列 表 中 管理 ~ 星 Kermit Miao/kermit™ 


流入 定义 管理 
作业 管理 


流程 实例 ID “流程 定义 ID 流程 名 称 流程 版 本 。 | 业务 KEY 
1002 leave-mall-tmeout:1:929 请 候 流 程 - 谍 件 任务 -销假 超时 提醒 1 

1106 timerStartEvent:1:1104 TimerStartEvent 

11 1 本 tirmerlmMiddie:1:1114 tmerinNliddle 


1201 leave'1:928 请 假 流 程 -普通 表单 


共 4d 亲 数据 | << 


图 14-10 ”流程 实例 列表 
图 14-10 中 的 列表 查询 之 前 已 经 介绍 过 ， 所 以 不 再 重复 ,读者 可 参考 本 书 配套 资源 的 ProcessinstanceManagerController.java 和 processinstance-listjsp。 


下 面 的 代码 展示 了 显示 图 14-10 中 处 理 “ 状 态 ” 列 的 逻辑 处 理 ， 根 据 流程 实例 的 状态 显示 对 应 的 按钮 。 


<C:forEach items="${page.result }" var="pi"> 
< 七 Q> 
${pi.suspended ? ' 挂 起 ' : ' 正 常 '} 
<c:if test="${pi.suspended}"> 
<a href="${ctx }/chapterl4/processinstance 
/active/${pi.id}"> 激 活 </a> 


</Cs Lif> 
<c:if test="${!pi.suspended}"> 
<a href="${ctx }/chapterl4/processinstance 
/suspend/${pi.id}"> 挂 起 </a> 


</c:if> 
</ 七 q> 
</c:forEach> 


代码 清单 14-2 列 出 了 处 理 挂 起、 激活 操作 的 Java 人 代码， 操作 成 功 后 返回 流程 实例 列表 。 


代码 清单 14-2 更改 流 程 实例 状态 


QRequestMapping (value = "{state}/{processInstanceId}") 
public String changeState (GPathVariable("state") String state, 
QPathVariable ("processInstanceld") String processInstancelId) { 
if (StringUtils.equals ("active", state)) { 

runtimeService.activateProcessInstanceById (processInstanceld); 
} else { 
runtimeService.suspendProcessInstanceByld (DrocesSsInstanceId) ， 


} 
return "redirect:/chapterl4/processinstance/list"; 


} 


需要 注意 的 是 ， 激 活 与 挂 起 流程 实例 操作 默认 会 级 联 操作 与 该 实例 相关 的 活动 ， 所 以 对 于 “任务 列表 ”、 “参与 的 流程 ”， 需 要 根据 流程 的 状态 过 滤 ， 也 就 是 只 查询 非 挂 起 的 数据 。 


查看 ProcessinstanceQuery 与 TaskQuery 对 象 均 提供 了 一 个 “active()” 方 法 ,调用 此 方法 后 只 能 查询 到 正常 状态 的 数据 ， 例 如 以 下 两 行 代码 分 别 可 以 查询 正常 状态 的 流程 实例 及 任务 。 


runtimeService .createProcessInstanceQuery () .active() .list() 
taskService.createTaskQuery () .active() .List() 


“请 假 (普通 表单 ) ”的 “任务 列表 ”使 用 的 标准 查询 ， 只 要 在 调用 list( 方 法 之 前 调用 一 次 active(0 即 可 ， 修 改 后 的 代码 如 下 : 


List<Task> todoList = taskService.createTaskQuery () 
0 0 0 taskAssignee (userTI 
.active( 

// 根据 汪 前 ;大 时 玲 忧 的 任务 

List<Task> unsignedTasks = taskService.createTaskQuery () 
‘processDefinitionKey ("leave"). taskCandidateUser (userId) 
activet(t})。 list()? 


2 


在 上 一 章 中 ， 为 了 满足 复杂 查询 使 用 了 NativeQuery 查 询 方式 ， 标 准 查 询 的 过 渡 方 式 就 不 能 满足 需求 了 ， 所 以 只 能 在 SQL 语 句 中 添加 过 渡 条 件 只 查询 正常 状态 的 数据 。 


在 原 有 的 查询 SQL 的 where 关 键 字 后 面 添加 如 下 的 条 件 即 可 ， 字 段 “SUSPENSION _STATE_” 值 为 “1” 表 示 正 常 状 态 ， 为 “2” 表示 挂 起 状态 。 


SUSPENSION STATE = '1' 


读者 可 以 参考 本 书 配套 资源 中 本 章 源码 的 TaskController.java 与 ExecutionController.java 文 件 的 SQL 语 句 。 


14.2 ”作业 管理 


一 般 来 说 ， 管 理 员 除了 能 查看 等 待 执行 的 作业 之 外 ， 还 可 以 删除 作业 和 手动 触发 作业 的 执行 动作 。Managementservice 接 口 的 两 个 方法 分 别 实现 作业 的 删除 与 执行 功能 ，API 如 下 : 


deleteJob (String jobId); 
executeJob (String jobIgd) 


在 图 14-9 对 应 的 代码 的 基础 上 再 添加 下 面 的 操作 链接 ， 对 应 的 控制 层 代码 如 代码 清单 14-3 所 示 。 


<tdq> 
<a href="execute/${job.id}"> 执 行 </a> 
<a href="delete/${job.id}"> 删 除 </a> 
</td> 


代码 清单 14-3 ”操作 作业 的 控制 层 代 码 


// 删除 作业 

GReduestMapping (value = "delete/{jobId}") 

public String deleteJob (PathVariable("jobIdq") String jobId 
managementService.deleteJob (jobId) ， 
return "redirect:/chapterl4/job/list"; 


Se 
一 


} 

// 手动 执行 作业 

QRequestMapping (value = "execute/ {jobId}") 

public String executeJob (GPathVariable ("jobld") String jobId 
managementService.executeJob (jobId) ， 
return "redirect:/chapterl4/job/list"; 


ge 
i 
一 


} 


14.2.1 作业 执行 原理 


在 所 接触 的 项 目 中 有 任务 调度 模块 可 以 代替 人 工 定时 处 理 一 些 系统 任务 ， 例 如 定期 备份 、 定 期 导出 报表 等 任务 。 


Activiti 中 的 作业 模块 的 实现 原理 与 大 多 数 任务 调度 框架 类 似 ， 利 用 定时 刷新 (间隔 5 秒 ) 的 方式 查询 需要 执行 的 作业 ， 具 体 的 执行 过 程 可 以 参考 如 图 14-11 所 示 的 作业 执行 原理 图 。 


保留 作业 ， 可 以 更 改 剩 
余 重 试 次 数 再 次 自动 
执行 ， 或 者 手动 执行 


记录 异常 信息 


作业 执行 失败 


作业 执行 成 功 


< 间隔 5 秒 查询 到 期 的 作业 ， 条 件 : 预定 时 间 小 于 等 于 当前 时 间 并 且 剩 余 重 试 次 数 大 于 0 ----> 


图 14-11 Activiti 中 作业 执行 原理 图 


14-11 中 底部 的 长 框 表示 查询 到 期 作业 的 守护 线程 ， 根 据 框 中 的 条 件 进 行 过 滤 。 


图 14-11 显 示 作业 执行 后 根据 执行 结果 分 为 两 种 不 同 的 处 理 方式 : 如 果 执 行 成 功 ， 处 理 的 逻辑 很 简单 ， 直 接 把 作业 记录 删除 就 完成 了 ， 如 果 在 作业 执行 失败 后 需要 处 理 异 常 ， 不 仪 要 记录 执行 的 异常 信 
息 ， 还 要 重新 执行 作业 (同时 可 重 试 次 数 减 一 ) ， 以 此 条 件 循 环 ， 直 到 作业 执行 成 功 后 正常 结束 或 剩余 重 试 次 数 为 0 后 结束 执行 ， 若 重 坛 了 3 次 后 作业 还 未 能 正常 执行 ， 此 时 可 以 选择 手动 执行 (不 限制 次 
数 ) 。 


14.2.2 ”作业 执行 异常 


在 作业 执行 过 程 中 可 能 会 遇 到 业务 异常 或 者 系统 异常 ， 对 于 这 种 情况 可 以 查询 作业 执行 时 的 异常 堆栈 (Exception Stacktrace) 信息 来 分 析 失 败 的 原因 。 


为 此 我 们 用 一 个 简单 的 例子 模拟 一 下 作业 执行 失败 的 情况 ， 做 法 是 在 执行 一 个 Java service 任务 时 故意 抛 出 一 个 RuntimeException 异 常 ， 判 断 是 否 抛 出 异常 的 条 件 是 当前 流程 实例 相关 作业 的 重 试 次 数 
是 否 大 于 0， 因 为 一 旦 将 作业 执行 失败 重 试 次 数 设置 为 0， 就 可 以 手动 执行 作业 。 


图 14-12 展 示 了 一 个 简单 的 流程 ， 该 流程 启动 后 会 创建 一 个 定时 作业 ，10 秒 后 继续 执行 ， 此 时 查看 图 14-13 的 “作业 管理 ”列表 的 数据 ， 列 “异常 消息 ”显示 “本 次 作业 执行 失败 ， 再 次 执行 可 以 成 
功 ! ”。 该 异常 信息 是 由 代码 清单 14-4 中 的 Java 类 抛 出 的 ， 观 察 控制 台 的 输出 会 发 现 异常 消息 输出 了 三 次 。 


-Uv- jobExecuteFail 中 | [1 JobExecuteFailExecutor.java 


屋 Markers | 围 Properties 器 | 几 Servers 辐 Console 名 Progress ,过 5earch JoJUnit 蓄 Debu 
| z 
ene Type: 他 ) Java Class 人 Expression 人 Delegate expression 
Main config 
Listeners 
Multilinstance | Result variable: 


Service class: me.kafeitu.activiti.chapterld.JobExecuteFailExecutor 


图 14-12 ”定时 作业 自动 执行 失败 示例 流程 


利 业 I ” 痢 业 类 型 ”额定 上 时间 可 重 试 次 粮 | 流程 定 半 上 ”流程 实例 |B 搜 行 但 | 异常 消息 作业 配置 仿 息 
来 次 作业 执行 秋 巾 ， 再 次 执行 可 以 成 功 ! timerintermedialecatchevent 


1559 ”中间 定时 2013-04-16 09:29:03 0 1555 1558 


图 14-13 ”启动 图 14-12 的 流程 10 秒 后 作业 的 执行 状态 
代码 清单 14-4 列 出 了 图 14-12 中 与 “Service Task” 的 “Service class” 属 性 关联 的 Java 类 。 


代码 清单 14-4 图 14-12 中 “Java Service” 实 现 类 


public class JobExecuteFailFExecutor implements JavaDelegate { 
public void execute (DelegateExecution execution) throws Exception { 
ManagementService managementService = execution 
.getEngineServices() .getManagementService () ; 
Job job = managementService.createJobQOuery () 
.DrocessInstanceId (execution.getProcessInstancelId()) .singleResult ();，; 


f (job.getRetries() > 0) { 
throw new RuntimeException (" 本 次 作业 执行 失败 ， 再 次 执行 可 以 成 功 ! ")， 


FE 


对 于 图 14-11 作 业 执 行 失败 的 情况 ， 引 警 会 记录 异常 信息 (图 14-13 中 的 “异常 消息 ”) 以 及 异常 堆栈 ( 见 图 14-14 所 示 ) ， 也 就 是 引擎 通过 tryhttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach ebook/uncompressed/15030/OEBPS/Text/...catch 语 句 捕获 异常 堆栈 并 保存 到 数据 库 。 


将 鼠标 移动 到 “异常 消息 ” 列 后 会 显示 图 14-14 中 的 异常 堆栈 ， 通 过 引擎 提供 的 接口 可 以 根据 作业 1D 读 取 异 常 堆栈 信息 、。 


Map<String, String> exceptionStacktraces = 
new HashMap<String, String>(); 


for (Job job : jobList) { 
if (StringUtils.isNotBlank (job.getExceptionMessage())) { 
exceptionStacktraces.put (job.getId(), managementService 
.getJobExceptionStacktrace (job.getIqd())); 


异常 消息 作业 配置 信息 


本 次 作业 执行 失败 ， 再 次 执行 可 以 成 功 ! timerintermediatecatchevent1 


全 java.lang.RuntimeException: 本 次 作业 执行 和 失败， 再 次 执行 可 以 成 功 ! 
at 
me.kafeitu.activiti.chapterl4.JobExecuteFailExecutor.executelJobExecuteFailExecutor.java:18) 
| at 
org.activiti.engine.impl.delegate.JavaDelegatelnvocation.invoketavaDelegatelnvocation.java: 
| 34) 

at 
org.activiti.engine.impl.delegate.Delegatelnvocation.proceed(Delegatelnvocation.java:37) 

at 
org.activiti.engine.impl.delegate.DefaultDelegatelnterceptor.handlelnvocation(DefaultDelegat 
elnterceptor.java:25) 

a 
org.activiti.engine.impl.bpmn.behavior.ServiceTaskjavaDelegateActivityBehavior.execute(Serv 
iceTaskjavaDelegateActivityBehavior.java:49) 

at 
org.activiti.engine.impl.bpmn.behavior.ServiceTaskjavaDelegateActivityBehavior.execute(Serv 
iceTaskjavaDelegateActivityBehavior.java:40) 

at org.activiti.engine.impl.bpmn.helper.ClassDelegate.execute(ClassDelegate.java:l116) 

at 
org.activiti.engine.im pl.pvm.runtime.AtomicOperationActivityExecute.execute(AtomicOperati 
onActivityExecute.java:44) 

at 
org.activiti.engine.impl.interceptor.CommandContext.performOperation(CommandCo 


图 14-14 ”作业 执行 失败 后 显示 的 异常 堆栈 信息 


最 后 把 Map 集 合 传递 给 展示 层 ， 根 据 作业 ID 获 取 异 常 堆栈 信息 即 可 ， 代 码 如 下 : 


<tqd title="$ {exceptionStacktraces[job.id]}"> 
${job.exceptionMessage}</td> 


假如 管理 员 看 到 图 14-14 的 异常 后 很 快 将 Bug 修 复 了 ， 需 要 重新 执行 该 作业 : 一 种 办 法 是 通过 手动 方式 执行 作业 ;另外 一 个 办 法 是 更 改作 业 的 “可 重 试 次 数 ” 属 性 以 便 再 次 被 引擎 检测 到 ， 这 样 可 以 再 次 
自动 触发 作业 执行 。 


14.2.3 ”独占 与 异步 


或 许 读者 已 经 注意 到 ， 在 使 用 Activiti Designer 设 计 流 程 时 任务 属性 中 的 “Asynch-ronous” 与 “Exclusive”， 之 所 以 前 面 的 章节 没有 介绍 ， 是 因为 要 理解 异步 与 独占 和 作业 有 一 定 的 关系 ， 现 在 已 经 
理解 了 作业 执行 的 原理 ， 是 时 候 介 绍 这 两 个 属性 的 用 途 了 。 


General 上 SFvicetaskK1 


Main config 
Listemers 
Multi instance 


Exclusive: 


图 14-15 ”用 Activiti Designet 设 计 流 程 时 的 异步 与 独占 选项 


异步 Asynchronous) 是 针对 并 行 任务 处 理 的 一 个 概念 。 图 14-16 所 示 的 是 一 个 包含 并 行 分 支 的 流程 ， 其 中 并 行 分 支 包 含 三 个 Java Service 任 务 ， 在 默认 情况 下 并 行 分 支 的 输出 流 关联 的 活动 都 是 同 
步 执 行 且 是 独占 ( 稍 后 介绍 ) 的 ， 也 就 是 说 先 执行 “任务 One” 表 执行 “任务 Two” 最 后 执行 “任务 Three”。 如 果 并 行 的 任务 执行 时 间 比 较 长 (可 能 几 分 钟 也 可 能 是 一 个 小 时 ) ， 那 么 后 面 的 任务 也 要 等 
待 前 面 的 任务 执行 完成 。 


任务 Three 


如 果 把 三 个 任务 都 设置 为 异步 ， 也 就 是 勾 选 图 14-15 的 “Asynchronous” 选 项 ， 在 该 流程 启动 之 后 会 创建 三 个 类 型 为 “async-continuation” 的 作业 记录 ， 用 于 记录 异步 作业 的 到 期 时 间 (与 其 他 的 定 
时 作业 的 到 期 有 所 不 同 ， 稍 后 介绍 ) 。 


独占 (Exclusive) 是 Activiti 引 擎 为 了 解决 乐观 锁 门 问题 采用 的 一 种 解决 办 法 ， 在 jBPM4 也 采用 了 相同 的 处 理 方式 。 简 单 来 说 就 是 同一 个 流程 实例 在 同一 时 刻 只 能 执行 一 个 任务 ， 从 而 避免 多 个 任务 同时 
执行 导致 事务 问题 。 


假如 将 图 14-16 的 三 个 并 行 任务 都 设置 为 异步 执行 ， 对 应 的 XML 如 下 (完整 的 流程 定义 可 参考 本 书 配 套 资料 中 本 章 源码 的 src/main/resources/chapter14/asynchronousAnd-Exclusive.bpmn 文 
件 ) : 


<serviceTask idq="servicetask1" name=" 任 务 One" 
activiti:async="true" activiti:exclusive="true" 
activiti:class="me.kafeitu.activiti.chapter14 
.AsynchronousExecutor"/> 


“activitiasync” 对 应 “asynchronous” 选项 ，“activiti:exclusive” 对 应 “Exclusive” 选项 ， 其 中 “activiti:exclusive” 可 以 省 略 ， 如 果 不 设置 引擎 ， 默 认 使 用 独占 模式 。 
为 了 彻底 理解 这 两 个 选项 对 流程 的 影响 ， 我 们 为 三 个 Java service 任务 设置 了 一 个 执行 类 (实现 了 JavaDelegate 接 口 ) ， 用 于 打印 执行 日 志 ， 见 代码 清单 14-5。 


代码 清单 14-5 图 14-16 中 “Java Service” 实 现 类 AsynchronousExecutor 


public class AsynchronousExecutor implements JavaDelegate { 
private Logger logger = LoggerFactory.getLogger (getClass ()); 
public void execute (DelegateExecution execution) throws Exception { 
logger.info (execution.getCurrentActivityName () + "--- 开 始 执行 任务 ") ， 
Long sleepSeconds = (Long) execution.dgetVariable ("SLeepSeconaQqs") ， 
// 根据 启动 流程 时 表单 填写 的 只 睡眠 来 模拟 耗 时 较 长 的 情况 
Thread.sleep (sleepSeconds * 10001) ， 
logger.info (execution.getCurrentActivityName () + "--- 任 务 完成 ")， 
} 
} 


有 了 理论 知识 ， 再 结合 AsynchronousExecutor 的 日 志 输 出 及 已 经 做 好 的 作业 列表 ， 我 们 就 可 以 分 别 根据 异步 、 独 占 选项 的 特点 来 分 析 测 试 类 的 执行 结果 ， 以 此 根据 实际 需要 决定 如 何 使 用 哪 种 模式 。 


首先 对 图 14-16 的 流程 进行 部 署 ， 然 后 启动 流程 输入 每 个 任务 等 待 的 时 长 (模拟 耗 时 较 长 的 场景 ， 默 认为 5 分 钟 ) 。 


启动 流程 一 [AsynchronousExecutor]， 版 本 号 : 1 


睡眠 肝 长 (种) : | 10 


制 返 回 到 表 | 启动 流程 


图 14-17 启动 流程 并 设置 任务 执行 等 待 时 长 为 10 秒 钟 
在 创建 异步 的 任务 (图 14-18) 时 会 同时 创建 对 应 的 作业 记录 (如 图 14-19 所 示 ) ， 到 期 时 间 为 创建 任务 的 时 间 加 5 分 钟 ， 图 14-18 中 的 到 期 时 间 为 04:33:30， 也 就 是 说 流程 的 启动 时 间 为 04:28:30。 


图 14-18 中 的 “作业 类 型 ”为 “异步 锁 ”， 英 文 标示 见 图 14-19 的 “HANDLER_TYPE_“” 字段 ， 可 以 直译 为 “异步 继续 ”， 但 是 笔者 认为 翻译 成 “异步 锁 ” 更 为 贴切 。 


作业 妆 型 预定 时 间 可 重 试 次 数 ”流程 定 总 ID 流程 实例 ID 执行 ID 异常 消息 ”作业 配置 情 息 


异步 锁 3 3401 23408 到 其 时间: 2013-04-21 04:33:;30 
项 标志 {UUID)Y: 6fid6di3-bale-446c-Bba2-8411 人 D87O01c 


异步 锁 9401 3409 到 期 时 间 : 2013-04-21 04:34:30 
锁 标 示 fUUID): 6ffd6df3-bala-4486c-Bba2-84f1f087001c 


到 期 时 间 : 2013-04-21 04:33:30 
钠 标 示 fUUICD): 6ffdedf3-bale-446c-8ba2-84f1f087001c 


SELECT FROM ACT RU OB: 
IREY_ ITYPE [LOCK ExP TIME JLO DWNER_ |ENDLUSUE_ |EXEOJTION ID |PROCESS Mh IPROC DEF ID |RETRIES |EXCEPTION STACK ID_ 
message 2013-04-21 6fid5df3-bale-4465-。|TRLE 3410 nul nut rut BSc 
| |16:33;30.124 Bbaz-84N 87001c | | | | | | contnuatlon 
messnge D13-04-21 6Fd6dF3-bale-44Ec- 9 ; , eyne- 
16:33:30.124 Bbaz-BAf1Ma700 1e continuation 


[rnessage 2013-04-21 SHBori-bale-4 Ar. | . me- 
] 才 :33:30.124 bata DSF Ic ccmntinuaticon 


图 14-19 ACT_RU_JOB 表 与 图 14-18 的 记录 对 应 
14-20 是 将 任务 设置 异步 且 独 占 后 控制 台 的 输出 结果 


9， bb [pool-1-thread-1] INFO [me,.kafeitu,.activiti, chapter14,AsynmchronousEXecutorj - 任务 0ne--- 开 始 热 行伍 锣 
,172 [pool=1=thread=1i] INFO [me,kafeitu,activiti,chapterid,AsynchronousExecutor] = 任务 0ne==- 任 务 完 成 
:199 [pool-1-thread-1] INFO [me,kafeitu.activiti.chapterl4.AsynchroncousEwecutor] - 任务 Two--- 开 始 执 行 任务 


人 
到 四 了 一 是 由 一 1 


2013-84-=21] 1 
2013-84-21 1 


- ,228 [pool=1=thread=1] INFO [me.Kkafeitu.activiti.chapterild.AsynchronousExecutor] = 任务 Three 一 开始 执行 任务 
: 232 [poo0l-1-thread-1] INFO [me,. Kafeitu.activiti,chapterld.AsynchronousExecutor] - 任务 Three 一 一 任务 完成 


6: 
6 
2013-84-21 16: -283 [pool-1-thread-1i] INFO [me.kafeitu.activiti,chapterid4.AsynchronousExecutor] - 任务 Two--- 任 务 完 成 
6: 
日: 


图 14-20 ”将 任务 设置 异步 且 独 占 后 控制 台 的 输出 
从 图 14-20 可 以 看 出 ， 昌 然 设 置 了 异步 但 是 和 预期 的 效果 不 同 ， 看 起 来 还 是 与 默认 的 同步 结果 一 致 ， 预 期 的 结果 应 该 是 这 样 的 : 


任务 One--- 开 始 执行 任务 
任务 Two--- 开 始 执行 任务 
任务 Three--- 开 始 执行 任务 
任务 One--- 任 务 完成 

任务 Two--- 任 务 完成 

任务 Three--- 任 务 完成 


导致 这 样 结果 的 原因 在 于 开启 了 独占 ， 因 为 在 独占 模式 下 在 同一 时 刻 只 能 执行 一 个 任务 ， 所 以 “抵消 ”了 异步 功能 。 好 的 ， 我 们 把 独占 模式 设置 为 “false” 再 观察 结果 。 下 面 的 配置 把 任务 的 独占 模式 
设置 为 false， 这 样 才 是 真正 的 异步 任务 处 理 。 


<serviceTask idq="servicetask1" name=" 任 务 One" 
activiti:async="true" activiti:exclusive="false" 
activiti:class="me.kafeitu.activiti.chapter14 
.AsynchronousExecutor"/> 


按照 刚刚 的 步骤 部 署 后 (流程 定义 的 版 本 号 为 2) 启动 流程 ， 查 看 作业 列表 和 数据 库 记 录 与 上 一 次 基本 无 差异 ， 但 是 流程 执行 结果 则 大 不 相同 ， 并 且 还 抛 出 了 异常 ， 如 图 14-21 所 示 。 


卫 卓 二 下 = 日 下 -= 也】 26:21:25,808 [peel=1=thread=2] INFO [me.kafeitu.activiti .chapterld.AsynechroneusExecuter] ( 王 秒 T 开端 执行 了 
28613=-04-21 20:21:25,809 [peel-1-thresd-1] INFO [me.kafeitu. setiviti .ehapterld4.AaynehreneusExeeuter] - E 务 0ne---= 开 始 执 | 
2613-B4-21 20:21:25,8608 [pocl-1-thread-3] INFO [me.kafeitu.activiti .chapterl4.AsynchronousExecutor] 尾 务 Three-- -开始 热 行 性 务 
2613-84-21 28:21:35,821 [pool-1-thread-2] INFO [me.kafeitu,.activiti.chapterl4.AsynchronousExecutor] - 尾 备 Two--- 尾 备 完 成 

旺 自由 当下 二 -= 号 让 35Bz21 [peol=-L-thread=3] INFO [me kafeitus activiti. chapterldAsynchroncusEeeytor] 性 各 Three-=== 尾 务 充 成 
2613-B4-21 26:21:35,821 [pocl-1-thread-1] TINFO [me.kafeitu.activiti.chapteril4.AsynehronousExecutor] - 尾 务 0ne--- 尾 务 完 成 


Exception 1n thread "pool-1-thread-1™" org.activiti.engine. ActivitiQOptimisticLockineExcepticon: ExecutionEntity[3585] was 


= - 


updated by ansther transactien econcurrently 
at org.activiti.engine.impl.db.DbsqlSession.flushUpdates(DbSqlSession. java:es3) 
at org.activiti.enginse,impl.db.D0bsqglsessicon.flushrDbsSgqlsessicons java:d6l’ 
at org.activiti.engine.impl.iinterceptor.CommandContext.flushSsessions(CommandContext .java: 168) 
at orgE.activiti.engine.inpl.intereceptor.CommandContext.close(commandContext,. java:11is) 
at org.activiti.engine,. impl.interceptor.CommandContextInterceptor .executetCommandContextInterceptor .java:7e) 
at org.activiti.spring.sSpringTransactionInterceptorsl.doInTransaction(springTransactionInterceptor.java:d42) 
at org.springframework.transaction.support.TransactionTemplate.execute(TransactionTemp late.Jjava:l3) 
at org.activiti.sprine. SpringTransactionlnterceptor .executel(SprineTransactionlnterceptors java:dd) 
at org.activiti.engine. mpLl.intereceptor.LogIntercepteor. executetLogInterceptor. java:31) 
at org.activiti.engine.impl.jobexecutor.ExecuteJobsRunnable.run(ExecuteJjobsRunnable,.java:46) 
at Javea. util,. eencurrent. ThreadPoelExecutersWerker. runTasktihreadPoolExecuter .ava:d9sy 
at java.util.concurrent.ThreadPoolExecutors$Worker.runtThreadPoolEwecutor.java:d1a) 
at java. Lang: Thread,.runtThread. Java:e6ae) 
Exception iin thread "pool-1-thread-2" org.activiti.eneine.ActivitiOptimisticLockingExcepticn: ExecutionEntity[3585] was 
updated by another transaction concurrently 


a5t Java. LaneE.Thread. runtihread.ava: eae 


图 14-21 更 改 任务 属性 为 异步 非 独占 后 的 执行 结果 


从 图 14-21 可 以 看 出 ， 任 务 的 执行 顺序 的 确 是 随机 的 ， 不 再 按照 One、Two、Three 的 顺序 ， 也 就 是 说 引擎 为 这 三 个 任务 分 别 开 启 了 一 个 线程 (Thread) 单独 执行 ， 而 在 独占 模式 下 同时 只 有 一 个 线程 
运行 ， 但 是 最 终 的 结果 是 引擎 抽出 了 乐观 锁 异 常 (ActivitiOptimisticLockingException) 。 从 图 14-21 中 可 以 看 出 异常 被 抛 出 了 两 次 (thread-1、thread-2) ， 原 因 是 第 一 个 任务 完成 时 更 改 了 流程 状态 信 
息 ， 接 着 其 他 两 个 任务 完成 也 要 更 改 ， 但 是 引 警 判断 发 现 已 经 被 更 改过 了 ， 所 以 抛 出 了 乐观 锁 异 常 。 


如 何 解决 这 个 问题 呢 ? 既然 引擎 不 能 支持 真正 的 异步 执行 ， 可 以 考虑 从 业务 角度 去 找 解决 办 法 ， 可 以 把 多 个 并 行 任务 合并 成 一 个 Java Service 任 务 ,创建 三 个 线程 分 别 执行 原来 需要 执行 的 任务 ， 这 样 就 
可 以 绕 过 乐观 锁 问 题 。 


[1] http://zh.wikipeqdia.ote/wiki/ 乐观 并 发 控制 


14.3 ”删除 流程 实例 


在 14.1 节 中 介绍 了 如 何 控制 流程 的 状态 ， 可 以 挂 起、 激活 流程 。 如 果 正 常 运行 的 某 个 流程 因 业 务 数据 错误 不 再 需要 了 ， 此 时 可 以 选择 删除 流程 实例 。 删 除 又 分 为 运行 时 与 历史 (归档 ) 两 种 : 
RuntimeService 接 口 与 HistoryService 分 别提 供 了 一 个 API 用 来 删除 对 应 类 型 的 流程 数据 。 


下 面 的 APl 是 RuntimeService 提 供 的 ， 在 Javadoc 中 也 做 了 说 明 ， 可 以 删除 正常 运行 的 流程 实例 ， 第 二 个 参数 的 意思 是 删除 流程 实例 的 原因 。 


aqeleteProcessInstance (String processInstancelgd, 
String deleteReason) 
Delete an existing runtime process instance. 


HistoryService 的 API 如 下 所 示 ， 无 需 传 递 删 除 原因 ， 因 为 运行 时 的 流程 实例 被 删除 之 后 会 把 删除 原因 记录 在 历史 流程 实例 中 ， 这 样 可 以 跟踪 流程 删除 的 原因 ， 方 便 业 务 方面 的 跟踪 。 


deleteHistoricProcessInstance (String processInstancelId) 
Deletes historic process instance. 


图 14-22 展 示 了 本 章 示例 中 添加 的 两 个 菜单 项 ， 分 别 为 “运行 中 流程 ”与 “已 归档 流程 ”， 用 于 管理 正在 运行 和 已 经 结束 的 流程 实例 。 


图 14-22 ”新 的 管理 菜单 项 
单 击 图 14-22 中 “运行 中 流程 ”菜单 项 后 进入 如 图 14-23 所 示 的 流程 实例 列表 。 单 击 图 14-23 中 的 删除 按钮 后 弹出 如 图 14-24 所 示 的 对 话 框 ， 提 示 输 入 删除 原因 ， 确 定之 后 将 请 求 发 送 至 /chapter14- 


management/chapter14/processinstance/delete/13223, 


流程 实例 ID ”流程 定义 ID 流程 名 称 
1002 leave-mail-timeout:1:929 请 假 流 程 -邮件 任务 -销假 超时 提醒 


1106 timerStartEvent:1:1104 TimerStartEvent 


1115 timerinMiddle:1:1114 timerinMiddie 


1201 laave:1:928 请 假 流程 -普通 表单 


1208 purchase-callactivity:1:923 办 公用 品 采 购 --callactivity 方 式 


共 14 条 数据 << 


图 14-23 ”添加 了 删除 按钮 的 运行 中 流程 实例 列表 


The page at localhost:8080 says: 
请 输入 删除 原因 : 


Greel | ED 辣 


图 14-24 单 击 图 14-23 中 的 删除 按钮 后 提示 输入 删除 原因 


请 求 中 的 13223 是 流程 实例 的 ID。 控 制 器 的 代码 如 下 所 示 (ProcesslnstanceManagerControllerjava) ， 由 于 展示 层 发 送 的 是 Ajax 请 求 所 以 控制 器 返回 一 个 true 表 示 成 功 执行 ， 同 时 该 流程 也 被 标记 为 
已 结束 ， 可 以 在 已 归档 流程 中 查看 结束 原因 ， 如 图 14-25 中 的 第 2、3 条 记录 的 “结束 原因 ” 列 所 示 。 


QRequestMapping (value = "delete/ {processInstanceId}") 
QResponseBody 
public boolean delete (GPathVariable ("processInstanceId") 


String processInstancelIgd, 
QRequestParam("deleteReason") String deleteReason) { 
runtimeService.deleteProcessIinstance (ProcessInstanceId， 
deleteReason);}; 


return true; 


流程 实例 ID 所 赂 流程 流程 定义 1D 启动 时 间 结束 时 间 父 流 竹 ID | 结束 原因 
1002 博 假 流程 - 趣 特性 务 -销假 超时 提醒 laava-mail-timeout:1:929 | 2013-04-06 08:33:06 i 2013-04-21 11:14:222 null 


TimaerstartEvent timaerStartEvent:1 :1104 | 2013-04-06 08:44:59 2013-04-21 11:37'52 
通用 付款 流程 payment:1:928 | 2013-04-08 08:38:18 2013-04-21 11:38:19 


该 作 业 在 执行 时 会 抛 出 辑 吝 jobExecuteFall:2:1518 (2013-04 -16 Og:28:22 | ke 2013-04-16 09:28:'46 


~ AsynchronousExecutor asynchronousExecutor:1:3208 |2013-04-21 08:44:38 kermit 2013-04-2109:59:31 | 


图 14-25 ”已 归档 流程 实例 列表 


在 第 13 章 的 HistoryProcesslnstanceControllerjava 控 制 器 中 添加 如 下 代码 完成 删除 已 归档 流程 实例 的 功能 ， 成 功 后 返回 列表 。 


QRequestMapping (value = "finished/delete/ {pid}") 
public String aeleteProcessInstance (GPathVariable ("pid") 
String ProcessInstanceId， 
RedirectAttributes redirectAttributes) { 
redirectAttributes.addFlashAttribute ("message", 
"ID 为 " + pid + "的 历史 流程 已 删除 ! ") ， 
historyService 
.deleteHistoricProcessInstance (ProcessInstanceId) ， 
return "redirect:/chapterl3/history/process" 
+ "/finished/manager"; 


14.4 ”流程 定义 权限 控制 
要 控制 流程 中 某 些 用 户 任务 能 够 被 哪些 人 或 组 签收 ， 可 以 通过 为 该 任务 设置 候选 人 或 候选 组 ， 如 果 把 需求 再 提升 一 级 ， 要 控制 哪些 候选 人 或 候选 组 可 以 启动 哪些 流程 ， 该 如 何 实 现 呢 ? 


14.4.1 权限 拦截 


从 Activiti 5.10 版 本 开始 引擎 把 用 户 任务 的 候选 配置 移植 到 了 流程 级 别 上 ， 从 而 可 以 根据 登录 系统 的 用 户 所 拥有 的 角色 决定 是 否 有 权 查 询 、 启 动 流程 。 图 14-26 是 办 公用 品 采 购 流程 ( 子 流程 版 本 ) 的 一 
个 副本 ， 把 ID 改 为 了 “purchase-authority” 表 示 一 个 特别 的 版 本 添加 了 候选 组 或 候选 人 限制 ， 即 图 中 的 “Candidate start users” 与 “Candidate start groups” 属性。 


Process ld: purchase-authority 
Listeners 


Name: 办 公用 品 采 购 ~- 添 加 了 启动 流程 权限 
Namespace: http:/ /www.kafeitu.me /activiti 
Candidate start Users (comma separated): 
Candidate start groups (comma separated): supportCrew | 


加 > 作 灿 尼 到 权限 


Documentation: 


图 14-26 ”为 流程 添加 候选 人 和 候选 组 


对 应 的 XML 如 下 : 


<process id="purchase-authority" isExecutable="true" 
name=" 办 公用 品 采 购 -- 添 加 了 启动 流程 权限 " 
activiti:candidateStarterUsers="kermit" 
activiti:candidateStarterGroups="supportCrew"> 


设置 了 属性 就 需要 在 查询 流程 定义 对 象 时 进行 过 滤 ， 可 以 通过 下 面 的 方法 过 滤 指 定 用 户 可 以 启动 的 流程 。 


repositoryService.createProcessDefinitionQuery () 
.StartableByUser (userId) .list(); 


如 果 使 用 上 面 的 代码 过 滤 流 程 定义 对 象 ， 得 到 的 结果 (用 户 thomas 属 于 supportCrew 组 ) 只 有 一 条 记录 ， 原 来 已 经 部 署 的 流程 和 没有 设置 候选 人 或 候选 组 的 流程 定义 对 象 将 不 会 包含 在 结果 中 。 很 显 
然 这 不 是 我 们 期 望 的 结果 ， 我 们 希望 用 户 能 查询 到 未 设置 候选 属性 及 设置 了 候选 属性 且 用 户 有 权 查 看 的 流程 定义 数据 。 


很 遗憾 ， 目 前 引擎 没有 直接 提供 类 似 的 接口 ， 也 没有 提供 ProcessDefinition 的 Native Query 查 询 APl， 所 以 我 们 要 想 一 些 “ 和 至 招 ”来 实现 。RepositoryService 接 口中 提供 了 一 个 这 样 的 方法 (如 图 14- 
27 所 示 ) ， 利 用 这 个 方法 可 以 在 流程 启动 时 读 取 流 程 定义 的 相关 候选 属性 ， 然 后 与 当前 用 户 的 属性 (ID 或 者 所 属 组 ) 进行 校 验 ， 以 此 来 决定 用 户 是 否 可 以 启动 流程 。 


List<IdentidtyLink> getIldentitvyLinksForProcessDefinition(String processDefinitionId) 
Retrieves the IdentityLinks assoclated with the given process definition. 


图 14-27 RepositorySetvice 接 口 提供 的 与 流程 定义 的 候选 属性 有 关 的 方法 
在 启动 流程 时 需要 读 取 启动 流程 的 表单 (无论 动 态 表单 还 是 外 置 表单 ) ， 在 读 取 表单 之 前 进行 权限 拦截 ， 更 改 ProcessDefinitionController.java 类 的 readStartForm 方 法 ， 见 代码 清单 14-6 所 示 。 


代码 清单 14-6 ”获取 启动 流程 表单 时 添加 权限 拦截 


@QRequestMapping (value = "getform/start/{processDefinitionId}") 
public ModelAndView readStartForm(@PathVariable ("processDefinitionId") 
String processDefinitionId, HttpServletRequest request, 
RedirectAttributes redirectAttributes) throws Exception { 
ProcessDefinition processDefinition = repositoryService.createProcessDefinitionQuery () 
.DrocessDefinitionId (DrocessDefinitionId) .singleResult () ， 
User user = UserUtil.getUserFromSession (request.getSession()); // 获取 当前 用 户 


List<Group> groupList = (List<Group>) request.getSession() .getAttribute ("groups"); 
boolean startable = false; // 是 否 可 以 局 动 流 程 的 临时 变量 
if (identityLinks == null || identityLinks.isEmpty()) { // 如 果 没 有 设置 表示 可 以 启动 


startable = true; 


} 

// 读 取 流 程 定义 的 候选 人 与 候选 组 

jst<IdentityLink> identityLinks = repositoryService 

. get] [dentityLinksForProcessDef finition (processDefinition.getId()); 
for (IdentityLink identityLink : identityLinks) { 

if (StringUtils.isNotBlank (identityLink.getUserId()) && // 候选 人 
identityLink.getUserId() .equals (user.getId())) { 


startable = true; 
break; 
} 
if (StringUtils.isNotBlank (identityLink.getGroupId() { // 候选 组 
for (Group group : groupList) { // 中 当前 潜入 组 往 二 匹配 
if (group .getName () .equals (identityLink.getGroupId())) { 
startable = true; 
break; 


} 

} 

if (!startable) { // 如 果 不 能 启动 设置 异常 信息 并 返回 流程 列表 
redirectAttributes.addFlashAttribute ("error", 


"您 无 权 启 动 【" + processDefinition.getName () + "】 流 程 ! "); 
return new ModelAndView ("redirect:/chapter5/process-— ee -View") ; 


} 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15030/OEBPS/Text/... // 省 略 了 读 取 表单 的 代码 


以 用 户 “henry” 登 录 系统 ， 启 动 刚刚 部 署 的 “purchase-authority” 流 程 后 显示 如 图 14-28 所 示 的 界面 ， 左 下 方 的 粗 线 边 框 中 显示 了 “您 无 权 启 动 【 办 公用 品 采 购 -- 添 加 了 启动 流程 权限 】 流 程 ! ” 信 
息 。 


plorer 。 会 首页 。 加 请 假 {普通 去 单 } ~ 友 已 归档 | 轩 流 程 列表 | 串 管 理 ~ 


您 无 权 启 动 【 办 公用 品 采购 -- 添 加 了 启动 流程 权限 】 流 程 ! 


图 14-28 ”启动 流程 时 的 权限 拦截 


14.4.2 ”设置 候选 启动 人 和 候选 启动 组 


除了 通过 在 设计 流程 时 设置 候选 人 和 候选 组 ， 还 可 以 动态 地 为 流程 定义 设置 候选 启动 人 和 候选 启动 组 。 如 图 14-29 所 示 ， 引 警 在 RepositoryService 接 口中 提供 了 AP 为 已 经 部 署 的 流程 定义 动态 添加 候选 
启动 人 和 候选 启动 组 。 


addCandidateBtarterGroup(String processDefinitionId, String groupId) 
Authorizes a candidate group for a process definition. 
addCandidateSBtarterUser(String processDefinitionId, String userId) 
Authorizes a candidate user for a process definition. 


图 14-29 ”RepositoryService 接 口中 提供 的 添加 候选 启动 人 和 候选 启动 组 的 API 


对 应 地 ， 也 可 以 动态 地 移 除 候选 启动 人 和 候选 启动 组 。 引 擎 也 提供 了 与 图 14-29 对 应 的 两 个 方法 ， 如 图 14-30 所 示 。 


deleteCandidateStarterGroup(String processDefinitionId, String groupId) 
Removes the authorization of a candidate group for a process definition. 
deleteCandidateStarterUser (String processDefinitionId, String userId) 
Removes the authorization of a candidate user for a process definition. 


图 14-30 ”RepositoryService 接 口中 提供 的 移 除 候选 启动 人 和 候选 启动 组 的 API 


在 图 14-31 的 流程 定义 记录 中 ，“ 候 选 启动 (人 ) ”与 “候选 启动 (组 ) ” 列 的 数据 就 是 通过 图 14-29 的 API 添 加 的 ， 单 击 图 14-31 中 的 “候选 启动 ”选项 后 可 以 看 到 如 图 14-32 所 示 的 设置 对 话 框 ， 勾 选 
后 单 击 对 话 框 的 “确定 ”按钮 即 可 。 


流程 定义 ID 部 署 ID 流程 定义 名 称 流程 定义 KEY 流程 描述 版 本 号 | XML | 流程 图 状态 候选 启动 。 操作 
asynehronousEwecutor:1:3208 | 3205 -AsynchronousEXxaecutor asynehronousExecuteor ” 异步 与 独占 1 查看 | 查看 正常 ”人 [中 , 组 [1] 


慨 选 启动 (人 1 | 候选 启动 (组 ) 


Andy Zhao | * 后 勤 人 人员 
Bill Zhang 


二 
s Henry Yan 
Kermit hlac 


图 14-31 为 流程 定义 设置 了 候选 启动 人 和 候选 启动 组 


设置 候选 启动 人 | 组 


是 候选 启动 (人) 四 候选 启动 (组 ) 


日 323 2323sss 日 管理 员 
口 Amy Zhang 国 出 纳 员 
国 Andy Zhao 日 部 门 经 理 
Bill Zheng 日 总 经 理 
日 Eric LI 日 人 事 经 理 


图 Henry Yan 图 后 勤 人 员 
口 Yan Henry 日 财务 人 员 
器 Jenny Luo 

图 Kermit Miao 

器 Thomas Wang 


加 Tom Wang 
器 Tony Zhang 


图 14-32 设置 候选 启动 (人 、 组 ) 对 话 框 


在 ProcessManagerController.java 类 中 添加 了 一 个 方法 用 于 接收 单 击 图 14-32 中 “确定 ”按钮 发 送 的 请 求 ， 以 获取 前 台 的 三 个 参数 : 流程 定义 ID、 用 户 (User) 数组 、 组 (Group) 数组 ， 然 后 把 请 求 
转交 给 ProcessDefinitionService.java ( 见 代 码 清单 14-7) 类 的 setStartables() 方 法 处 理 ， 见 代码 清单 14-8 所 示 。 


代码 清单 14-7 ”接收 设置 候选 启动 请 求 


QRequestMapping (value = "startable/set/{processDefinitionId}", 
method = RequestMethod.POST) 
QResponseBody 
public String addStartables (GPathVariable ("processDefinitionId") String processDefinitionIg, 
QRequestParam(value = "users[]", required = false) String[] users, 
QRequestParam(value = "groups[]", required = false) String[] groups) { 


processDefinitionService.setStartables (processDefinitionId, users, groups); 
return "true™}; 


代码 清单 14-8 ”设置 流程 定义 的 候选 启动 人 和 候选 启动 组 


public void setStartables (String processDefinitionId, String[] userArray, String[] groupArray) { 
// 清理 现 有 的 设置 


List<IdentityLink> links = repositoryService 


.getIdentityLinksForProcessDefinition (processDefinitionId); 
for (IdentityLink link : links) { 
if (StringUtils.isNotBlank(link.getUserId())) { // 候选 人 


repositoryService.deleteCandidateStarterUser (ProcessDefinitionId， 
link.getUserId()); 


if (StringUtils.isNotBlank (link.getGroupId())) {// 候选 组 
repositoryService.deleteCandidateStarterGroup (processDefinitionIg, 
link.getGrouplId()); 


} 


// 循环 添加 候选 人 
if (!ArrayUtils.isEmpty (userArray)) { 
for (String user : userArray) { 
repositoryService.addCandidateStarterUser (processDefinitionId, user); 


} 


// 循环 添加 候选 组 

if (!ArrayUtils.1isEmpty (groupPArray) ) { 

for (String group : groupArray) { 
repositoryService.addCandidateStarterGroup (processDefinitionId, group); 


} 


14.4.3 ” 读 取 候选 启动 数据 


单 击 图 14-31 中 “人 [种 ， 组 [1]” 后 会 在 记录 的 下 方 显示 已 经 设置 的 候选 启动 数据 ， 与 上 一 小 节 设 置 候选 启动 数据 类 似 ， 引 擎 也 提供 了 对 应 的 读 取 APl， 如 图 14-33 所 示 。 


List<IdentityLink> getIidentityLinksForProcessDefinition(S8tring processDefinitionIid) 


Retrieves the IdentityLinks associated with the given process definition. 


图 14-33 ”RepositoryService 接 口 提供 的 读 取 候选 启动 数据 API 


把 流程 定义 1D 作 为 参数 传递 给 图 14- 0 然后 再 根据 ldentityLink 对 象 的 值 判断 候选 类 型 是 人 还 是 组 。 在 本 书 配套 资源 第 5 章 源码 包 的 DeploymentController 类 
的 processList() 方 法 中 根据 查询 到 的 流程 定义 对 象 列 表 循 环 读 取 候选 启动 数据 ， 然 后 再 根据 流程 定义 对 象 进行 分 组 传递 给 页 面 即 可 。 


代码 清单 14-9” 读 取 流程 定义 相关 的 候选 启动 人 和 候选 


QRequestMapping (value = "/process-list") 

public ModelAndView processList (HttpServletRequest request) { 

http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15030/0EBPS/Text/... 

List<ProcessDefinition> processDefinitionList = processDefinitionQuery 

.listPage (pageParams[0], pageParams [1]); 

http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15030/0EBPS/Text/... 

// 读 取 每 个 流程 定义 的 候选 属性 

Map<String, Map<String, List<? extends Object>>> linksMap = 
setCandidateUserAndGroups (processDefinitionList); 

mav.addobject ("linksMap", linksMap); 

return mav; 


} 
private Map<String, Map<String, List<? extends Object>>> 
setCandidateUserAndGroups (List<ProcessDefinition> processDefinitionList) { 

Map<String, Map<String, List<? extends Object>>> linksMap = new HashMap<String, Map<String, List<? extends Object>>>(); 
for (ProcessDefinition processDefinition : processDefinitionList) { 

List<] [dentityLink> identityLinks = repositoryService 

.getIidentityLinksForProcessDefinition (processDefinition.getlId()); 

Map<String, List<? extends Object>> single = 
new Hashtable<String, List<? extends Object>>(); 
List<User> linkUsers = new ArrayList<User> () ， 
List<Group> linkGroups = new ArrayList<Group> (); 
for (IdentityLink link : identityLinks) { 
if (StringUtils.isNotBlank (link.getUserId())) { // 候选 人 
linkUsers.add (identityService.createUserQuery () 
.userId (link.getUserId()) .singleResult ()); 
} else :if (StringUtils.isNotBlank (link.getGroupId())) { // 候选 组 
linkGroups.add (identityService.createGroupQuery () 

.groupId (link.getGroupId()) .singleResult ()); 


l 
} 
single.put ("user", linkUsers); 
single.put ("group", linkGroups); 
linksMap.put (processDefinition.getId(), single); 


} 


return linksMap; 


es 


最 后 在 展示 层 从 linksMap 对 象 中 获取 流程 定义 ID 对 应 的 IdentityLink 对 象 集合 ， 循 环 处 理 即 可 显示 如 图 14-31 中 的 数据 。 下 面 列 出 了 展示 层 的 代码 片段 。 


<tr> 
< 七 Q> 
<ul Cass="uSsers"> 
<c:forEach var="user" 
items="${linksMaplpd.id]j['user']}" > 
<li>${user.firstName} S${user.lastName}</1i> 
</c:forEach> 


<ul class="groups"> 
<c:forEach var="group" 
items="${linksMaplpd.id]['group']}"> 
<1i>${group.name}</1i> 
</c:forEach> 


AN 


擎 属性 


引擎 提供 了 一 个 便捷 的 接口 可 以 快速 获取 引擎 配置 信息 ， 图 14-34 展 示 了 引擎 的 相关 属性 ， 读 取 属 性 的 代码 如 下 : 


Map<String,String> prop = managementService.getProperties () ， 


器 请假 《普通 表单 ) ~ 器 运 行 中 ~ 而 已 归档 ”。 沁 流 程 列表 | 回 管 


引擎 配置 


属性 名 称 | 属性 值 
nextdbid ”下 一 作 自 增 忆 !( 主 键 ) | 4301 


schema,.history pn pr ot creareto. Te) 


schema.version 前 [让 问 | 又 小 引擎 配置 参数 5.12 


图 14-34 引擎 配置 参数 界面 


14.6 ”数据 库 查 询 


本 书 开始 时 介绍 了 如 何 使 用 H2 的 Web 界 面 查 看 引擎 的 数据 库 (包括 结构 及 记录 ) ， 为 了 方便 开发 者 ， 引 擎 提供 了 查询 引擎 数据 库 的 接口 ， 用 于 获取 与 引擎 数据 库 表 的 结构 、 记 录 。 此 功能 封装 在 
ManagementService 接 口中 ， 相 关 API 见 图 14-35 所 示 。 


Map<String, Long> gaetTableCount() 
Get the mapping containing {table name, row count} entries of the Activitl database schema. 


TableMetaData getTableMaetaData(String tableName) 
Gets the metadata (column names, column types, etc.) of a certain table. 


TablePagenQuery createTablePagenQueryl) 
Creates a TablePageQuery that can be used to fetch TablePage coNtaining Specific sections of 
table row data. 


图 14-35 与 数据 库 查 询 有 关 的 API 


图 14-36 展 示 了 数据 库 查 询 页 面 的 效果 图 ， 左 侧 列 出 了 引擎 的 所 有 表 名 称 以 及 每 张 表 的 记录 数量 ， 在 单 击 表 名 后 右 侧 会 分 页 显示 表 中 的 记录 ， 具 体 实现 见 代 码 清单 14-10 所 示 。 


引擎 数据 库 getTableMetaData(*ACT, ID MEMBERSHIP’) 


表 名 红 tableCount0 记录 (ACT_ID_MEMBERSHIP) 


ACT_RU VAAIABLE (22) 

ACT_RU_EVENT_SUBSCR 鹏 时 | 
ACT_RE_DEPLOYMENT 
ACT_RE_PROCDEF (15) 
ACT_HI_TASKINST (12 
ACT_HIL_ACTINST (58) 
ACT ID INFO (0) 

ACT_ID MEMBERSHIP (12) 
ACT_RU_TASK (6) 
ACT_RU_JOB (0) 
ACT_GE_BYTEARRAY (40) 
ACT_HI_VARINST (834) 
ACT_AE_MODEL (0) 
ACT ID GROUP (7) 
ACT_HI_PAOCINST (16) 
ACT_HI_ATTACHMENT (0) amy deptLeader 
ACT_ID_USER (12) 

ACT_HI_COMMENT (0) 失 12 条 数据 
ACT_RU_IDENTITYLINK (21) 
ACT_RU_EXECUTION {14) 
ACT_HI_DETAIL (18) 

ACT GE_ PROPERTY (3) 


deneralvanadger 
hr 

deptLeader 
deptLeader 
treasurer 
cashier 


thomas supportCrew 


器 LE = La en 七 i Pa 


在 ITW 性 hier 


一 上 
总 


createTablePageQuery():tableNamel(tableName).listPage(1, 10) 


图 14-36 ”引擎 的 数据 库 ( 表 结 构 及 记录 ) 


代码 清单 14-10” 读 取 引 擎 数据 库 


@QController 
@RequestMapping ("/chapter14/database") 
public class DatabaseController { 


GAutowired 

ManagementService managementService; 

QRequestMapping ("") 

public ModelAndView index (GRequestParam(value = "tableName", required = false) 
String tableName, HttpServletRequest request) { 


ModelAndView mav = new ModelAndView ("chapterl4/database"); 
// 读 取 表 《〈 表 名 ， 记 录 数 量 ) 
Map<String, Long> tableCount = managementService.getTableCount () ， 
mav.addobject ("tableCount", tableCount); 
// 读 取 表 记录 ， 在 页 面 单 击 左 边 的 表 名 后 传递 LableName 参 数 
if (StringUtils.isNotBlank (tableName)) { 
TableMetaData tableMetaData = managementService 
.getTableMetaData (tableName); 

mav.addobject ("tableMetaData", tableMetaData); 
Page<Map<String, Object>> page = new Page<Map<String, Object>>(10); 
int[] pageParams = PageUtil.init (page, request); 
TablePage tablePages = managementService.createTablePageQuery () 

.tableName (tableName) .listPage (pageParams[0], pageParams [1]); 
page.setResult (tablePages .getRows () ); 
page.setTotalCount (tableCount .get (tableName) ); 
mav.addobject ("page", page); 


return mav; 
} 
} 


TableMetaData 对 象 可 以 获取 指定 表 中 的 字段 名 称 (getColumnNames0 方 法 ) 及 字段 类 型 (getColumnTypes0 方 法 ) 集合 对 象 。 从 TablePage 对 象 中 可 以 通过 调用 getRows0 方 法 获取 记录 和 集合， 类 型 为 
Map<String，Object>， 这 样 可 以 根据 字段 名 称 获取 对 应 的 值 。 读 者 可 以 参考 database.jsp 查 看 展示 层 的 实现 。 


14.7 用户 与 组 


对 于 如 何 通过 API 管 理 用 户 、 组 在 第 5 章 已 经 介绍 过 了 ， 本 章 的 主题 是 管理 员 特 性 ， 所 以 关于 用 户 、 组 的 管理 是 必 不 可 少 的 内 容 。 本 节 不 再 介绍 相关 API 的 使 用 。 本 章 的 随 书 配套 资源 中 提供 了 完整 的 演 
示 ， 读 者 可 以 参考 本 章 源码 的 IdentityController,java 与 user-list.jsp 及 group-listjsp。 用 户 和 组 的 管理 效果 如 图 14-37 和 图 14-38 所 示 。 


四 请 慨 【普通 表单 ) Y - 上 已 归档 ” ” 哩 流 程 列表 | 器 营 理 * 


旦 用 户 管理 演 组 管理 流程 定义 管理 


运行 中 流程 
已 归档 流程 


用 户 列表 


引擎 配置 参数 
用 户 ID 姓名 Emalil 引擎 数据 库 
1111 323 2323883 2323 作业 管理 


aimy Army ehang amy@localhoast 
andy Andy Zhao andyBlocalhost 
bill Bil Zheng billBlocalhost 


党 Erie LI 意 『 了 夸 | 吕 Cheoet 


其 12 荣 数 扬 < 及 


图 14-37 ”用户 管理 界面 


组 列表 新 增 / 编 辑 组 


组 ID 目光 条 D: generalManager 


到 rmi 


总 经 理 
cashier 


deptLeader 定 类 开 : 安全 角色 


generallyianager 宇 时 


共 7 条 数据 


图 14-38 ”组 管理 界面 


14.8 ”本 章 小 结 


本 章 作为 实战 篇 的 最 后 一 章 对 所 有 与 管理 员 有 关 的 功能 特性 进行 了 详细 的 讲解 ， 其 中 涉及 的 管理 员 特 性 可 以 让 企业 的 系统 管理 员 全 权 管 理 流程 数据 。 


管理 员 除 了 能 够 查询 引擎 中 的 所 有 数据 之 外 ， 还 可 以 控制 流程 及 流程 定义 的 状态 ( 挂 起 、 激 活 ) ， 当 然 读 者 在 实际 操作 中 也 可 以 把 状态 控制 操作 移植 到 任务 办 理 界面 (切记 控制 好 操作 权限 ) 。 另 外 控 
制 流程 定义 权限 可 以 避免 越权 操作 ， 减 少 垃圾 数据 的 产生 。 


作业 管理 是 引擎 中 一 个 比较 重要 的 功能 ， 除 了 管理 各 种 定时 事件 产生 的 作业 之 外 ， 还 要 承担 异步 类 型 的 作业 管理 任务 ， 因 此 管理 员 可 以 通过 该 模块 干预 作业 的 执行 、 查 看 作业 执行 结果 ， 遇 到 作业 执行 
失败 时 可 以 把 作业 的 有 异常 信息 报告 给 IT 部 门 或 者 供应 商 。 在 14.2.3 节 中 对 流程 任务 的 独占 与 异步 执行 进行 了 详细 的 分 析 ， 并 且 分 析 了 乐观 锁 问 题 的 原因 并 给 出 了 如 何 绕 过 乐观 锁 问 题 的 解决 办 法 。 


最 后 简单 介绍 了 如 何 读 取 引 警 的 数据 库 信息 (结构 、 记 录 ) 及 引 警 属性 。 


相信 经 过 前 面 的 学 习 ， 大 家 已 经 掌握 了 Activifti 的 大 部 分 功能 以 及 应 用 场景 ， 可 以 根据 需求 设计 流程 图 ， 根 据 业 务 逻 辑 控制 流程 的 走向 ， 基 本 上 可 以 满足 企业 应 用 中 80% 的 基本 需求 了 。 


接 下 来 的 部 分 为 高 级 篇 ， 是 Activiti 作 为 一 个 BPM Platform (BPM 平 台 ) 不 可 或 缺 的 一 部 分 内 容 。 与 企业 现 有 系统 或 功能 模块 集成 ， 把 Activiti 作 为 一 个 业务 流程 的 调度 中 心 ， 让 多 个 系统 各 司 其 职 ， 用 流程 
把 复杂 的 业务 串联 起 来 ， 当 某 个 环节 需要 内 部 或 外 部 系统 提供 服务 时 可 以 利用 引擎 的 内 置 或 扩展 的 组 件 与 具体 模块 交互 ， 从 而 完成 流程 中 的 交互 任务 。 


这 部 分 的 内 容 包括 集成 Webetvice、 规 则 引擎 、ESB (Enterptise Service Bus ， 企 业 服 务 总 线 ) 、JPA (可 以 把 流程 变量 保存 在 数据 库 的 表 中 ) ， 以 及 可 以 用 CDI 方 式 注 册 引 擎 组 件 。 


第 15 章 ”集成 WebService 


在 企业 应 用 中 ， 与 外 界 系统 交互 可 以 选择 WebService、Socket、HTTP 协 议 或 者 类 WebService (早期 没有 Webservice 时 通信 双方 先 组 装 再 解析 XML) 方式 。 目 前 大 多 数 系统 都 是 通过 SOAP (Simple 
Object Access Protocol， 简 单 对 象 访问 协议 ) 方式 ， 它 提供 了 标准 的 RPC (Remote Procedure Call Protocol， 远 程 过 程 调用 协议 ) 方法 调用 WebService。 


在 第 4 章 中 提 到 ，Webservice 任 务 不 是 BPMN 2.0 规 范 的 一 部 分 ， 而 是 由 Activiti 在 ServiceTask 的 基础 上 扩展 而 来 的 (读者 也 可 以 自己 扩展 实现 ， 后 面 的 章节 会 详细 介绍 ) 。 只 要 在 流程 中 引入 
WebService 接 口 的 XML 定 义 以 及 相关 的 参数 就 可 以 通过 WebService 方 式 交 互 ， 当 然 交 互 的 结果 完全 可 以 作为 流程 变量 存在 并 可 以 在 网 关中 作为 表达 式 的 一 部 分 控制 流程 的 走向 。 


同 才 | 伤 
《> 是 否 需 要 
人 总 经 理 审批 】 


WebService 任 务 不 需要 
需要 


本 章 以 请 假 流程 (动态 表单 ) 为 例 演示 如 何在 流程 中 集成 WebService 任 务 控制 流程 走向 ， 对 应 的 流程 图 如 图 15-1 所 示 。 


田 
部 门 领导 审批 


bb 措 绝 一 | 中 
请 求 被 驳回 后 员工 
可 以 选择 继续 申请 ， 
或 者 取消 本 次 申请 
结束 流程 


图 15-1 包含 了 WebService 任 务 的 请 假 流程 


销假 


与 第 6 章 的 请 假 流程 相 比 ， 图 15-1 中 新 增 了 两 个 任务 : 是 否 需要 总 经 理 审批 、 总 经 理 审 批 ， 前 者 提供 业务 逻辑 判断 ， 当 申请 的 天 数 大 于 3 天 时 任务 流转 至 “总 经 理 审 批 ”， 否 则 流转 至 “销假 ”。 


15.1 发 布 WebService 服 务 


要 提供 Webservice 服 务 ， 首 先 要 创建 并 发 布 一 个 可 以 提供 请 假 天 数 判断 的 Webservice， 这 里 我 们 使 用 Apache CXF (http://cxf.apache.org) 框架 发 布 WebService 服 务 。 代 码 清单 15-1 列 出 了 一 个 标 
准 的 LeaveWebService 接 口 定义 。 


代码 清单 15-1 LeaveWebService 接 口 


package me.kafeitu.activiti.chapterl15.1leave.ws; 
import javax.jws.WebParam; 
import javax.jws.WebResult; 
import javax.jws.WebService; 
@WebService 
public interface LeaveWebService ({ 
/** 
* 是 否 需 要 总 经 理 审批 
* Q@param startDate 请 假 开始 时 间 
* Q@param endDate ”请 假 结束 时 间 
* Q@return truel|false 
wy 
QWebResult (name="needed") 
boolean generalManagerAudit (QWebParam (name = "startDate") String startDate, 
QWebParam (name = "endDate") String endDate); 


接着 定义 一 个 LeaveWebService 接 口 的 实现 类 LeaveWebServicelmpl， 见 代码 清单 15-2 所 示 。 


代码 清单 15-2 ”LeaveWebService 接 口 实 现 类 LeaveWebServicelmpl 


package me.kafeitu.activiti.chapterl15.1leave.ws; 
QWebService (endpointIinterface = "me.kafeitu.activiti.chapterl5.leave.ws.LeaveWebService",serviceName = "LeaveWebService") 
public class LeaveWebServiceImpl implements LeaveWebService 1 
// 计算 开始 日 期 与 结束 日 期 相差 天 数 
public int daysBetween (Date startDate, Date endDate) { 
JDateTime joddSstartDate = new JDateTime (startDate); 
JDateTime joddEndDate = new JDateTime (endDate); 
int result = joddStartDate.daysBetween (joddEndDate); 
return result; 


} 
QOverride 
public boolean generalManagerAudit (String startDate, String endDate) { 

SimpleDateFormat sdf = new SimpleDateFormat ("yyyy-MM-dd HH:mm"); 
Int days = 0; 
iy 


days = daysBetween (sdf.parse (startDate), sdf.parse (endDate) ) ， 
} catch (ParseException e) 1 
logger .error ("解析 日 期 出 错 : startDate={}, endDate={}"，startDate, endDate); 


return days > 3 ? true : false; 


代码 清单 15-2 简 单 实现 了 LeaveWebservice 接 口 ， 判 断 请 假 天 数 超过 三 天 时 返回 true， 否 则 返回 false。 


为 了 使 接口 的 实现 类 LeaveWebServicelmpl 的 逻辑 符合 我 们 的 预期 ， 有 必要 为 这 个 接口 实现 进行 单元 测试 。 假 设 发 布 的 WebService 接 口 的 URL 定 义 为 “http://localhost:9999/leave”， 当 然 真 实 应 用 
应 该 是 一 个 IP 地 址 或 者 域名 ， 本 例 为 了 演示 暂且 使 用 localhost 作 为 服务 的 地 址 。 


为 了 方便 测试 ， 


代码 清单 15-3 LeaveWebService 接 口 工 具 类 LeaveWebserviceUiil 


public class LeaveWebserviceUtil { 
public static 
public 0 inal Stri 


URL = "http://local 
DL URL = WEBSE JRV 


Pun) lic stat inal Stri 
"nttp://ws. je chapter15.acti 
private static Server server = null; 
// 发 布 Nebservice 
public static void startServer() { 
LeaveWebService leaveWebService = new LeaveWebsSe 
// 也 可 以 用 Apache CXF 方 式 发 布 
Endpoint .publish (WEBSERVICE URL, ee 
+ WEB 


viti.kafeitu.me/"; 


rviceImpl (); 


); 1 


System.out. println ("请 假 WebService 已 发 布 : 


} 

// 停止 Webservice 服 务 

public static void stopServer() { 
if (server != null) { 


server.destroy(); 
} 
} 
public static void main(String[] args) { 
startServer (); 


} 
] 


在 调用 LeaveWebServiceUtil 的 main 方 法 或 者 startServer 方 法 之 后 ， 控 制 台 打 印 了 如 图 15-2 所 示 的 输出 ， 表 示 WebService 服 务 已 经 成 功 发 布 ， 现 在 在 浏览 器 中 访问 “http://localhost:9999/leave? 


wsd|” 后 就 可 以 看 到 如 图 15-3 所 示 的 XML 定义 。 


[局 LeaveWebserviceUtil 


Wa Ma aa 


09:38:52,488 
99:38:52,488 
09:38:52,488 
99:38:52,488 
909:38:52,488 
09:38:52,488 


| 
[main] 
[main] 
[main)] 
[main] 
[main] 
[main | 


请 假 Webservice 已 发 布 : 


图 15-2 


封装 了 一 个 LeaveWebService 接 口 的 工具 类 LeaveWebServiceUtil， 可 以 方便 启动 、 停 止 WebService 服 务 ， 


[host: 0 
CE U. 十 "?wsd1l' 


RVICE URL + "?wsd1"); 


ber Bs bah Wa Wah 


DEBUG 
DEBUG 
DEBUG 
DEBUG 
DEBUG 
DEBUG 


见 代码 清单 15-3 所 示 。 


CT 
org.apache.cxf.]axws.handLer 
org.apache.cxf.]axws.handLer 
Drg.apache.cxf.]axws.handLer， 
org.apache. cxf. jaxws.handLer 
org.apache. cxf. jaxws. handler 
org.apache. cxf. jaxws. handler 


http:// localhost:9999/ Leaverwsdl 


通过 LeaveWebServiceUtil 工 具 类 发 布 了 WebService 服 务 


.人 | localhost:9999 /leave?wsd| 


This XML file does not appear to have any style mformation associated with 


T<weadlidefinitions xmlnsixsd="httpi/ /Ww wi3.0rg/2001/XMLSchema" 
xmlns:tns="http://ws.leave.chapterlS5.activiti,.kafeitu.me/" xmli 
name="LeaveWebService" targetMamespace="http://ws.leave.chapte 
Tv<wedl:tvpes> 

T<xSSchema xmlns:xs= "http:/ /Ww .wi3.o0rg/2001/xXMLSchema” xmln 
targetNamespace="http:i/ /ws. leave.chapterl5.activiti,.kafeitu 
<xsS!:element name="generalManagerAudit"” type="tns:generalM: 
<xSielement name=" generalManagerAuditResponse” type= tnast:oe 
T<xXg:complexType name="generalManacdcerAudit "> 
VY<xS: SedUence> 
<xselement minOccurs="0" name="startDate" type="xs:st 
<XEIelement minOcecurs="0" name="endDate"” tvype=" XxS:8Stri 
</xXS :Sequence> 
</xXs:complexType> 
T<xXS!CCmmlexType name="generalManadgerAuditResponse"> 
VT<xXS: SeEqUence> 
<xs:element name="needed'" type="xs:boolean'" /> 
</XS:Sequence> 
</xa:complexType> 
</xa19Chema> 
</wsdl:types> 


图 15-3 LeaveWebService 接 口 的 WSDL 内 容 
接着 编写 一 个 简单 的 单元 测试 来 验证 判断 请 假 天 数 的 逻辑 ， 测 试 类 名 称 为 LeaveWeb-ServiceBusinessTest， 见 代码 清单 15-4 所 示 。 


代码 清单 15-4LeaveWebServiceBusinessTest 单 元 测试 


public class LeaveWebServiceBusinessTest { 

// 需要 总 经 理 审批 

@Test 

public void testTrue() throws ParseException ({ 
JaxWsProxyFactoryBean factory = new JaxWsProxyFactoryBean () ， 
Factory.getInInterceptors () .add (new LoggingInIinterceptor () ) ， 
factory.getOutIinterceptors() .aqd (new LodggingoutInterceptor () ) ， 
factory.setServiceClass (LeaveWebService.class); 
factory.setAddress (LeaveWebserviceUtil .WEBSERVICE URL); 
LeaveWebService leaveWebService = (LeaveWebService) factory.create(); 
boolean audit = leaveWebService.generalManagerAudit ( 

"2013-01-01 09:00", "2013-01-05 17:30") 7 


assertTrue (audit); 


} 
从 代码 清单 15-4 中 可 以 看 出 ， 从 2013-01-01 请 假 到 2013-01-05 肯 定 大 于 3 天 ， 所 以 WebService 返 回 的 结果 应 该 是 “true”。 当 然 这 里 的 判断 不 严谨 ， 在 实际 应 用 中 还 要 判断 上 下 班 的 边界 值 ,i 
以 自行 扩展 。 很 显然 单元 测试 可 以 顺利 通过 ， 如 图 15-4 所 示 。 


LeaveWebServiceBusinessTest.testTrue 


| J 地 


了 (testTrue (me.kafeity.activiti.chapterl5.leave.LeaveWebServiceBusinessTest) 


图 15-4 LeaveWebServiceBusinessTest 单 元 测试 的 执行 结果 


抱歉 ， 这 里 “浪费 ”了 几 分 钟 时 间 做 了 一 些 准备 工作 ， 创 建 并 发 布 了 可 用 Webservice， 并 且 对 健壮 性 进行 了 简单 的 测试 ， 这 样 就 没有 了 后 顾 之 忧 ， 下 面 可 以 切入 正题 了 。 


15.2 ”在 流程 中 定义 WebService 任 务 


图 15-1 中 新 添加 的 “是 否 需 要 总 经 理 审批 ”Service 任 务 要 实现 Webservice 服 务 的 调用 需要 以 下 几 个 步骤 : 
. 引入 WebService 的 Scheme。 
声明 interface。 
. 定义 message。 
定义 输入 、 输 出 Data。 
在 阅读 本 节 内 容 时 可 以 结合 本 书 配套 资源 中 本 章 示例 代码 (bpmn20-example 项 目 ) 的 /chapter15/leave-webservice.bpmn 文 件 。 


从 文件 头 部 的 definitions 标 签 开始 ， 加 入 如 下 属性 定义 : 


targetNamespace="me. kaf itu.activiti,. chapterlSs. leave.ws" 
xmlns:tns="me.kafeitu.activiti.chapterl15. Teave: WS" 
xmlns:leave="http://webservice.kafeitu.me" 


紧 接着 引入 WSDL， 在 流程 运行 时 引擎 从 WSDL 中 获取 WebService 的 定义 ， 然 后 把 该 地 址 交 给 Apache CXF 处 理 。 


<import importType=http://schemas.xmlsoap.org/wsdl/ 
location="http://localhost:9999/leave?wsdl1" 
namespace="http://webservice.kafeitu.me/" /> 


importType 属 性 的 值 是 WSDL 的 Scheme 引 用 (必须 定义 ) ，location 是 实际 应 用 中 已 经 发 布 的 Webservice 的 WsDL 地 址 ，namespace 属 性 的 值 与 “xmlns:leave” 保 持 一 致 。 


下 面 的 代码 列 出 了 interface 的 定义 ， 用 来 声明 Webservice 接 口 的 operation 以 便 “ServiceTask” 中 可 以 引用 定义 的 接口 (operation 的 id 属性 ) 。 


<!-- jnterface: implementationRef 属 性 的 值 要 与 WSDL (wsdl :portType) 中 的 保持 一 致 ， 即 eWebService 中 的 serviceName 属 性 --> 
<interface name="Leave Audit Interface" 
implementationRef="]leave:LeaveWebservice"> 
<!-- operation: implementationRef 属 性 的 值 也 要 与 WSDL 中 的 保持 一 致 (wsdl:operation) --> 
<operation id="auditOperation" 
name="General Manager Audit Operation" 
implementationRef="]eave:generalManagerAudit"> 
<inMessageRef> 
tns:generalManagerAuditRequestMessage 
</inMessageRef> 
<outMessageRef> 
tns:generalManagerAuditResponseMessage 
</outMessageRef> 
</operation> 
</interface> 
<!-- 定义 message， 参 考 wsdl 文 件 中 的 wsdl :message 的 定义 --> 


<message id="general ManagerAuditRequestMessage" 
itemRef="tns:generalManagerAuditRequestItem" /> 
<message id="generalManagerAuditResponseMessage" 
itemRef="tns:generalManagerAuditResponseItem" /> 
<!-- 参考 wsdl :input --> 


<itemDefinition id="generalManagerAuditRequestItem" 
structureRef="leave:generalManagerAudit"™" /> 
<1-- 参考 wsdl:output --> 
<itemDefinition id="generalManagerAuditResponseItem" 

structureRef="leave:generalManagerAuditResponse" /> 


对 于 上 面 的 代码 ， 可 以 结合 图 15-3 中 的 XML 理解 ， 虽 然 标签 比较 多 ， 但 是 都 有 层级 、 引 用 关系 ， 根 据 xxxRef 属 性 跟踪 即 可 。 


基于 ServiceTask 定 义 WebService 任 务 需 要 设置 “implementation” 这 个 特殊 的 属性 ， 且 其 固定 值 定义 为 “##WebService”， 再 通过 “operationRef” 属 性 定义 触发 哪个 WebService 操 作 。 


<!-- 定义 变量 --> 
<itemDefinition id="needed" structureRef="boolean"/> 
<itemDefinition id="startDate" structureRef="string"/> 
<itemDefinition id="endDate" structureRef="string"/> 
<serviceTask id="checkGeneralManagerAudit" 
name=" 是 这 否 需 要 总 抽 \ 经 理 审批 " 
implementation="##WebService" 
operationRef="tns:auditOperation"> 
<ioSpecification> 
<qataInput id="dataInput" 
itemSubjectRef="tns:generalManagerAuditRequestItem"/> 
<dataOutput id="dataOutput" 
itemSubjectRef="tns:generalManagerAuditResponseItem"/> 
<inputSet> 
<dataInputRefs>dataInput</dataInputRefs> 
</inputSet> 
<outputSet> 
<dataOutputRefs>dataOutput</dataOutputRefs> 
</outputSet> 
</ioSpecification> 
<dataInputAssociation> // 输入 数 
<sourceRef>startDate</sourceRef> 
<targetRef>startDate</targetRef> 
</dataInputAssociation> 
<dataInputAssociation> 
<sourceRef>endDate</sourceRef> 
<targetRef>endDate</targetRef> 
</dataInputAssociation> 
<dataOutputAssociation> // 输出 数 
<sourceRef>needed</sourceRef> 
<targetRef>needed</targetRef> 
</dataOutputAssociation> 
</serviceTask> 


mu 


mHl 


用 ioSpecification 标 签 定义 输入 输出 对 象 。 用 datalnputAssociation 定 义 接口 的 输入 参数 (来 源 与 流程 变量 ) 。 用 dataOutputAssociation 定 义 接口 的 输出 结果 (保存 到 流程 变量 中 ) : 其 中 sourceRef 和 
targetRef 必 须 设 置 ， 即 使 这 两 个 值 相同 也 不 可 省 略 ， 定 义 的 名 称 需 要 用 “itemDefinition” 预 先 定 义 ， 用 属性 “structureRef” 定 义 变量 的 类 型 ， 该 属性 允许 为 空 不 过 为 了 显示 地 标记 变量 的 类 型 可 以 用 Java 
的 类 型 进行 定义 ， 例 如 示例 中 的 “string” 


15.3 ”在 流程 中 调用 WebService 


大 概 了 解 了 XML 如 何 定义 及 多 个 标签 之 间 的 关系 ， 再 结合 代码 清单 15-5 的 单元 测试 执行 结果 进行 分 析 ， 相 信 读 者 很 快 就 明白 这 其 中 的 奥秘 。 


不 过 在 运行 单元 测试 之 前 需要 先 把 activiti-cxf 模 块 加 入 到 项 目 中 ， 在 项 目的 pom.xml 中 添加 如 下 配置 ，activiti-cxf 模 块 会 依赖 Apache CXF， 如 果实 际 项 目 已 经 依赖 了 Apache CXF， 要 注意 版 本 号 的 差 


<dependency> 
<groupId>org.activiti</groupId> 
<artifactId>activiti-cxf</artifactId> 
<version>${activiti.version}</version> 
</dependency> 


代码 清单 15-5” ”LeaveWebservicelnWorkflowTest 单 元 测试 


public class LeaveWebserviceInWorkflowTest extends AbstractTest { 
// 调用 Webservice 后 决定 是 否 需 要 总 经 理 审批 
@Test 
QDeployment (resources = "chapterl5/leave-webservice.bpmn") 
public void testWithWebservice() throws Exception { 
ProcessDefinition processDefinition = 
repositoryService.createProcessDefinitionQuery () 
.processDefinitionKey ("leave-webservice") .singleResult () ， 
// 启动 流程 《请 假 时 间 段 间隔 4 天 ) 
ttp://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15030/0EBPS/Text/... 
部 门 领导 审批 通过 
tp://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15030/0EBPS/Text/... 


h 
// 
ht 
// 人 事 审批 通过 
ht 
// 
Bo 


tp://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15030/0EBPS/Text/... 
判断 Webservice 任 务 执行 结果 
Boolean needed = (Boolean) runtimeService 

.getVariable (processInstance.get1ld(), "needed"); #1 
assertTrue (needed); 


由 于 代码 清单 15-5 的 单元 测试 需要 动态 读 取 Webservice 的 WSDL， 因 此 再 运行 单元 测试 只 要 先 执行 LeaveWebserviceUtil.startServer() 方 法 发 布 WebService。 


从 图 15-5 中 可 以 看 出 通过 了 单元 测试 ，LeaveWebService 中 的 generalManagerAudit 方 法 返回 了 名 称 为 “needed” 结 果 ， 在 流程 文件 中 又 把 该 结果 设置 到 同名 的 变量 中 ， 所 以 代码 清单 15-5 中 的 #1 处 查询 
名 称 为 “needed” 的 变量 结果 为 true。 


ma LeaveWeDserviceltil LeaveWebservicelnWorktlowTest.testWithnWebservice 


* EL . Bi 


了 testWithWebservice (me.kafeitu.activiti.chapterl5 .leave.LeaveWebservicelnWorkflowTest) 


图 15-5 ”代码 清单 15-5 的 单元 测试 执行 成 功 


15.4 ”本 章 小 结 
本 章 介 绍 了 企业 应 用 中 与 外 界 系 统 交 互 的 一 种 方式 一 一 WebService。WebService 任 务 并 未 包含 在 BPMN 2.0 规 范 中 ， 而 是 Activiti 基 于 serviceTask 扩 展 的 一 个 自 定义 任务 类 型 。 引擎 对 WebService 任 
务 提供 了 基础 的 功能 支持 ， 可 以 把 调用 外 部 WebService 任 务 作为 流程 的 一 个 步骤 ， 从 而 更 有 利于 企业 流程 的 规划 。 


本 章 首先 介绍 了 如 何 发 布 一 个 简单 的 Webservice 服 务 ， 然 后 又 介绍 了 如 何 把 发 布 的 Webservice 引 入 到 流程 定义 文件 中 ， 最 后 介绍 了 如 何 把 流程 数据 传递 给 Webservice， 以 及 如 何 获取 Webservice 接 
口 返回 的 处 理 结果 。 


第 16 章 ”集成 规则 引擎 
规则 引擎 可 以 像 流 程 引擎 一 样 谋 入 在 应 用 中 。 利 用 规则 引 警 可 以 将 业务 规则 脱离 应 用 单独 维护 ， 使 用 预定 义 的 规则 文件 语法 编写 业务 规则 ， 把 业务 数据 交 给 规则 引擎 解释， 然后 返回 处 理 结果 ， 根 据 返 
回 的 结果 可 以 判定 业务 的 处 理 方式 ， 有 点 类 似 BPMN 2.0 规 范 中 的 路 由 功能 。 


Activiti 目 前 对 BPMN 2.0 规 范 中 的 “BusinessRuleTask” 做 了 基本 的 实现 ， 使 用 了 JBoss 公司 的 规则 引擎 一 Drools。Drools 也 是 目前 比较 流行 的 规则 引擎 之 一 ，JBoos 公 司 发 布 的 BPM5 引 警 也 是 在 
Drools 的 基础 上 开发 的 。 


在 15.1 节 的 请 假 流程 中 ， 利 用 Webservice 判 定 请 假 天 数 是 否 超过 3 天 以 决定 是 否 需要 总 经 理 审 批 ， 本 节 将 利用 规则 引擎 完成 相同 的 功能 。 


16.1 定义 流程 与 规则 


图 16-1 与 图 15-1 类 似 ， 只 不 过 在 图 16-1 中 把 WebService 任 务 换 成 了 BusinessRule-Task (是 否 需要 总 经 理 审批 ) ， 可 以 在 流程 设计 器 中 配置 一 些 规则 有 关 的 参数 ， 如 图 16-2 所 示 。 


图 16-2 的 配置 对 应 的 XML 如 下 所 示 ， 对 XML 的 定义 可 以 参考 4.3.5 节 对 业务 规则 任务 的 属性 说 明 。 


<businessRuleTask id="checkGeneralManagerAudit" 
name=" 是 否 需要 总 经 理 审批 " 
activiti:rules=" 检 查 是 否 需 要 总 经 理 审批 " 
activiti:ruleVariablesInput="$ {leave}" 
activiti:resultVariable="rulesOutput" /> 


EE 
部 门 领导 审批 


本 


请 求 被 驱 回 后 员工 
可 以 选择 继续 申请 ， 
或 者 取消 本 次 申请 


3 
总 经 理 审 批 


图 16-1 包含 BusinessRuleTask 的 请 假 流 程 


2/ Markers 


Rule names: 检查 是 天 需要 总 经 理 审 指 


Input variables: $1leave} 


Excluded: DYes@No 


Result variable: rulesOutput 


图 16-2 ”图 16-1 中 “是 否 需 要 总 经 理 审批 ”任务 的 属性 配置 
把 XML 转 换 成 文字 可 以 这 么 理解 ， 把 参数 “$fleave}” 传 递 给 名 称 为 “检查 是 否 需要 总 经 理 审批 ”的 规则 (rule) ， 在 执行 完 规则 后 把 结果 保存 到 变量 “rulesOutput” 中 。 
代码 清单 16-1 列 出 了 判定 请 假 天 数 的 规则 定义 ， 上 有 具体 可 以 查看 bpmn20-example/test/resources/leave.drl 文 件 。 


代码 清单 16-1 请假 规则 文件 定义 


package me.kafeitu.activiti.chapterl15; 
import me.kafeitu.activiti.chapterl5.drools.Leave 
import jodd.datetime.JDateTime; 
import org.activiti.engine.impl.persistence.entity.ExecutionEntity; 
rule "检查 是 否 需 要 总 经 理 审批 " 
when 
$leave: Leave(); // 接收 从 引擎 传递 的 变量 ， 根 据 类 型 匹配 
then 
JDateTime joddStartDate = new JDateTime ($leave.getStartTime ()); 
JDateTime joddEndDate = new JDateTime ($leave.getEndTime ()); 
int result = joddStartDate.daysBetween (joddEndDate); 
// 请 假 天 数 大 于 3 天 


$leave.setGeneralManagerAudit (result > 3); 


end 


16.1.1 部署 规则 文件 


要 调用 规则 ， 首 先 需要 把 规则 文件 部 署 到 引擎 数据 库 中 ， 规 则 文件 扩展 名 为 “.drl|”。Activiti 默 认 不 支持 该 类 型 的 文件 ， 需 要 在 引擎 配置 对 象 中 配置 一 个 可 以 解析 规则 文件 的 部 署 器 ， 配 置 如 下 : 


<bean id="processEngineConfiguration" 
class="org.activiti.engine.impl.cfg 


.StandaloneInMemProcessEngineConfiguration"> 
<!-- 部 署 drl 文 件 时 需要 设置 一 个 自 定义 的 部 署 解析 类 --> 
<property name="customPostDeployers"> 
<list> 
<bean class="org.activiti.engine 
.impl.rules.RulesDeployer" /> 


</list> 
</property> 
</bean> 


在 上 面 的 配置 中 设置 了 引擎 配置 对 象 的 “customPostDeployers” 属 性 ,添加 了 支持 规则 文件 的 部 署 器 ， 把 规则 文件 交 给 Drools 解 析 处 理 ， 这 样 在 流程 运行 时 引擎 可 以 调用 Drools 的 API 执 行规 则 。 该 
部 署 器 实现 了 org.activiti.engine.impl.persistence.deploy.Deployer 接 口 ， 如 果 需 要 自 定义 部 署 器 ， 可 以 实现 该 接口 并 添加 实现 类 到 “customPost-Deployers” 属 性 中 。 


16.1.2 单元 测试 


代码 清单 16-2 列 出 了 包含 业务 规则 任务 的 单元 测试 代码 。 


代码 清单 16-2 LeaveWithBusinessRuleTest 单 元 测试 


public class LeaveWithBusinessRuleTest extends AbstractTest { 


QTest 
QDeployment (resources = {"chapterl5/leave-drools.bpmn", "chapterl5/leave.drl"}) #1 
public void testWithWebservice() throws Exception 1{ 


ProcessDefinition processDefinition = 
repositoryService.createProcessDefinitionQuery () 

.processDefinitionKey ("leave- drools") .singleResult ();，; 

Leave leave = new Leave(); #2-S 

SimpleDateFormat sdf = new SimpleDateFormat ("yyyy-MM-dd HH:mm"); 

Map<String, String> variables = new HashMap<String, String>(); 

Calendar ca = Calendar.getIinstance(); 

Jeave .SetStartTime (ca.getTime () ) ， 

String startDate = sdf.format (ca.getTime () ) ， 


ca.add (Calendar.DAY OF MONTH，4); // 当前 期 加 4 天 
leave. setEndTime (ca.getTime () ) ， #2-E 
// 启动 流程 (请 假 时 间 段 间隔 4 天 ) 
runtimeService.setVariable (processInstance.getId(), "leave", leave); #3 

// 部 门 领导 审批 通过 
DN 0 sources/teach ebook/uncompressed/15030/0EBPS/Text/.. 
// 审批 通过 

p://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15030/0EBPS/Text/.. 


7 多 饭 9roo1s 执 行 结果 

Leave leaveOutput = (Leave) runtimeService #4-S 
.getVariable (processinstance.get1ld(), "leave"); 

assertTrue (leaveOutput.isGeneralManagerAudit () )，; #4-E 


// 返回 的 结果 集 
// 如 果 没 有 设置 activiti:resultVariable 属 性 默认 的 名 称 为 : 

// org.activiti .engine.rules .OUTPUT 

Collection<Object> ruleOutputList = (Collection<Object>) #5-S 
runtimeService.getVariable (processInstance.getId(), "rulesOutput"); 
assertNotNull (ruleOutputList); 
assertEquals (1, ruleOutputList.size()); 

Jeave = (Leave) ruleOutputList.iterator() .next(); 

assertTrue (leave.isGeneralManagerAudit () ) ， #5 一 EE 


代码 清单 16-2 对 流程 做 了 一 个 简单 的 测试 ， 期 间 会 调用 规则 文件 ( 见 代 码 清单 16-1) ， 最 后 验证 执行 结果 (流程 流转 至 总 经 理 审批 ) 。 

在 #1 处 除了 部 署 流程 文件 (leave-drools.bpmn) 之 外 ， 还 部 署 了 规则 文件 (leave.drl) ， 当 解析 leave.drl 文 件 时 将 规则 文件 内 容 交 给 org.activiti.engine.impl.rules.RulesDeployer 类 处 理 。 
在 #2 处 创建 了 一 个 Leave 对 象 用 于 设置 请 假 的 时 间 及 保存 规则 处 理 结果 

在 #3 处 设置 了 流程 变量 “leave”， 也 就 是 流程 定义 文件 中 属性 “activiti:ruleVariables-Input” 的 表达 式 中 需要 使 用 的 变量 。 


在 #4 处 从 流程 中 读 取 变量 检查 规则 执行 结果 ， 获 取 “leave” 变 量 后 检查 general-ManagerAudit 属 性 为 true (#4-E 处 ) 。 需 要 注意 的 是 #4-S 处 获取 的 leave 对 象 与 #3 处 设置 的 leave 对 象 不 是 同一 
在 规则 文件 执行 完成 后 引 警 会 把 Drools 返 回 的 对 象 。 


16.2 ”本 章 小 结 
本 章 实 现 的 功能 与 上 一 章 相 同一 一 判断 请 假 的 时 间 是 否 超 过 3 天 ， 但 是 方法 不 同 。WebService 任 务 依赖 外 部 的 服务 来 完成 判断 ， 本 章 则 利用 BPMN 2.0 规 范 的 Business Rule 任 务 完成 。 利 用 JBoos 公 司 
的 Drools 作 为 规则 引擎 ， 把 流程 文件 与 规则 定义 文件 一 同 部 署 到 Activiit 中 即 可 在 流程 中 调用 。 


注意 的 是 ， 引 擎 默认 不 支持 规则 定义 文件 的 部 署 、 解 析 ， 所 以 当 使 用 规则 定义 文件 时 要 在 引擎 配置 中 注册 规则 来 部 署 实现 类 。 


第 17 草 集成 JPA 


JPA (Java Persistence APl) 在 大 多 数 系统 中 已 经 得 到 广泛 应 用 ， 从 1.0 标 准 到 目前 的 2.0 标 准 ， 越 来 越 多 的 开源 框架 发 布 了 自己 的 JPA 实 现 ， 例 如 Hibernate、Open JPA、Spring Data 等 。 
在 Activiti 中 使 用 MyBatis 作 为 ORM 层 ， 读 者 可 能 会 问 JPA 和 Activiti 有 什么 关系 ? 


让 我 们 先 回 顾 一 下 动态 表单 、 外 置 表单 的 一 些 特点 ， 所 有 的 表单 数据 都 保存 在 引擎 的 一 张 表 中 ， 然 而 时 间 长 了 之 后 数据 会 越 来 越 大 ， 而 且 数 据 没 有 结构 很 难 查 询 、 优 化 ， 这 也 是 有 些 企业 不 选择 使 用 这 
两 种 表单 的 原因 ， 在 Activiti 中 集成 JPA 就 是 为 了 解决 这 个 问题 。 


在 Activiti 集 成 JPA 后 可 以 把 动态 表单 或 外 置 表单 产生 的 “ 行 ” 式 人 存储 转换 为 “ 列 ” 式 人 存储， 也 就 是 把 业务 数据 保存 在 用 户 自 定 义 的 表 中 ， 这 样 有 利于 数据 的 查询 。 


17.1 配置 JPA 

我 们 知道 ， 引 擎 使 用 MyBatis 作 为 ORM。 可 能 有 的 读者 会 有 疑问 : “在 集成 JPA 后 ，JPA 会 与 MyBatis 有 冲突 吗 ? ”答案 肯定 是 没有 ， 因 为 两 者 是 完全 分 离 的 ， 使 用 JPA 都 是 面向 接口 编程 的 ， 在 引擎 
部 只 是 做 了 一 些 封装 、 集 成 的 工作 ， 并 且 对 MyBatis 和 JPA 的 事务 统一 管理 。 

表 17-1 列 举 了 引擎 配置 对 象 中 有 关 JPA 的 属性 及 其 合 义 。 


表 17-1 Activiti 引 擎 配置 对 象 中 有 关 JPA 的 属性 及 其 含义 


jpaPersistenceUnitName 


jpakEntityManagerFactory 


jpaHandleTransaction 


jpaCloseEntityManager 


17.1.1 


在 引擎 


代码 清单 17-1 


属 


在 引擎 


性 名 称 


Standalone 模 式 


中 集成 JPA 很 简单 ， 只 需要 人 在 引 和 


属性 说 明 


ND 入 化 年 元 的 名 名 称 ( 要 确保 该 持久 化 单元 在 类 路 径 下 是 


默认 的 路 径 是 /META-INF/persistence.xml) ce Ee, 


捍 一 修 加 可 


可 用 的 ) 


“实现 了 和 ax.persistence.EntityManagerFactory 的 bean 的 引用 ( 


ee 异 块 提供 


oryBean)。 该 属性 与 jpaPersistenceUnitNam 选择 一 个 即 可 


是 否 由 引擎 来 管理 JPA 的 事务 ， 


- 般 情 况 下 使 用 Spring、JTA 或 由 容 纪 


根据 该 规范 ， 
j jpaEntityManagerFactory 这 


例如 spring- 


-的 org.springframework.orm.jpa.LocalContainerEntityManagerFact 


提供 的 统 


事务 管理 功能 把 此 属性 设置 为 false，Standalone 模式 设置 为 true 
表示 流程 引 敬 是否 应 该 关闭 从 EntityManagerFactory 获取 的 EntityManager 的 实 
例 ， 和 jpaHandleTransaction 类 似 ， 如 果 使 用 了 容 需 管理 事务 设置 为 false， 


置 为 true 


擎 配置 对 象 中 设置 持久 化 单元 (Persistence Unit) 名 称 即 可 。 代 码 清单 17-1 列 出 了 Standalone 模 式 配置 JPA 的 代码 片段 。 


Standalone 模 式 中 配置 JPA 


tion" nMemProcessE 


<bean id="processE 
http://www.hzco 
<propert 
<proper 


<property 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15030/0EBPS/Text/... 


</bean> 


17.1.2 Spring 模式 


相信 目前 大 多 数 应 用 都 是 使 用 Spring 来 统一 管理 事务 ， 所 以 这 里 着 重 介绍 一 下 使 用 Spring 代 理 引 等 


‘ngineConfigura 


class="org.activiti.engine.impl.cfg.StandalonelI 'ngineConfiguration"> 


Urse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15030/0EBPS/Text/... 
ty name="jpaPersistenceUnitName" value="aia-jpa-pu" /> #1 

ty name="jpaHandleTransaction" value="true" /> 

name="jpaClosel 


EntityManager" value="true" /> 


代码 清单 17-2 列 出 了 在 Spring 模式 中 配置 JPA。 


代码 清单 17-2 在 引擎 


<bean id=" 


<property nam 
<bean 
<const 


hiberna 


teJpaVendorAdapt1 


Spring 模 式 中 配置 JPA 


[er 


class="org.springframework.orm.jpa.vendor.HibernateJpaVendorAdapter"> 


fac 


</bean> 
</property> 


</bean> 
<bean id=" 


<prop key=" 
<prop key=" 


ent 


<proper 


<proper 


</property> 


</bean> 


<bean id="hibernateJpaVendorAdapter" 


</bean> 


ructor-arg re 


ityManagerFactory" class="org.springf 
rEntityManagerFactoryB 
<proper 
ty name="jpaVen 
<proper 
ty name="jpaPro 


ty name="dataSo 


ty name="packag 


hibernate. sho 


="databasePlatf 
tory-method="get 
f="dataSource"/> 


orm"> 
Dialect" 


class="me.kafeitu.activiti.utils.Hibernates"> 


ramework.orm.jpa.LocalContaine 


ean"> 

urce" ref="dataSource"/> 

dorAdapter" ref=" ibernateJaVendor dries /> 
esToScan" value="me.kafeitu.activiti"/> 
perties"> 
w_sql">true</prop> // 打开 显示 SQL 开 关 


"hibernate . 


<!-- Spring Data Jpa 配 置 --> 


<jpa:repositories base-package="me. kaf 


<!-— JPA 事务 


<bean id=" 


</bean> 


<bean id="processE 


务 配 置 --> 
transact 
<property nam 


entity-manager 


format sql">true</prop> // 由 


Hibernate 格 式 化 引擎 执行 的 SOL 


class="org .spring: 


framework .orm.jpa.vendor.HibernateJpaVendorAdapter"> 


eitu.activiti" transaction-manager-ref="transact 


f="entityManagerFactory"/> 


ijonManager" 


-factory-re 


ijonManager" cl 
="entityManage 


‘ngineConfigura 


ass="org.springframework.orm.Jjpa.JpaTransactionManager"> 
rFactory" ref="entityManagerFactory"/> 


tion" class="org.activiti.spring.SpringProcessEngineConfiguration"> 


</bean> 


<property name=" 
<property name=" 


<!-— UPA --—> 
<property name=" 
<property name=" 
<property name=" 


datas 
trans 


jpaEn 
jpaHa 
jpacl 


ource" ref="dataSource" /> 


actionManager" ref="transactionManager" /> 
tityManagerFactory" ref="entityManagerFactory" /> #1 
ndleTransaction" value="false" /> #2 
oseEntityManager" value="false" /> #3 


擎 配置 对 象 时 如 何 集成 JPA， 稍 后 的 示例 也 是 基于 Spring 模式 进行 讲解 的 。 


合 由 设 


对 比 代码 清单 17-1- 与 代码 清单 17-2， 代 码 清单 17-2 中 除了 必要 的 EntityManager-Factory 及 事务 管理 器 之 外 ， 最 大 的 区 别 在 于 #2、 


Spring) 管理 事务 且 不 关闭 EntityManager 实 例 。 


17.2 JPA 版 本 的 请 


在 之 前 的 章 


节 中 我 们 接触 到 了 不 同 版 本 的 请 假 流程 ， 本 章 内 容 将 以 动态 表单 版 本 的 请 假 流 程 为 基础 进 


假 流程 


#3 处 的 两 个 属性 的 值 均 设置 为 false,， 


= | 


局 心 


思 就 是 由 容 


器 (这 里 指 的 是 


行 改 造 ， 目 的 是 在 流程 启动 时 可 以 自动 创建 实体 对 象 并 保存 到 数据 库 表 ， 流 程 图 如 图 17-1 所 示 。 


果 ) 


EY 
部 门 领导 审批 


重新 申请 人 结束 流程 


改造 的 内 容 如 下 : 

1) 流程 启动 时 创建 请 假 实体 并 持久 化 到 数据 库 。 

2) 保存 部 门 领导 审批 意见 到 请 假 表 (AlA_C17_LEAVE) 。 
3) 保存 人 事 审批 意见 到 请 假 表 。 

4) 保存 销假 节点 填写 的 内 容 。 


在 第 7 章 介 绍 普通 表单 时 创建 了 表 “LEAVE” 
， 如 图 17-2 所 示 。 


， 为 了 和 之 前 有 所 区 分 ， 


请 求 被 驳回 后 员工 
可 以 选择 继续 申请 ， 
或 者 取消 本 次 申请 


图 17-1 ”请假 流程 图 


所 以 本 章 会 使 用 “AlA C17_LEAVE” 作 为 新 的 数据 表 ， 在 “LEAVE” 的 基础 上 添加 了 两 个 


字段 (部 门 领 


导 审 批 结 果 、 人 事 审批 结 


show columns from aia cl?7 leave; 
FIELD TYPE 

ID BIGINT(19) 
APPLY_TIME TIMESTAMP(23) 
DEPT_LEADER_APPROVED VARCHAR(255) 
END_TIME TIMESTAMP(23) 
HR_APPROVED VARCHAR(255) 
AVE_TYPE VARCHAR(255) 
PROCESS_INSTANCE ID VARCHAR(255) 
REALITY END TIME TIMESTAMP(23) 
REALITY START TIME TIMESTAMP(23) 
REASON VARCHAR(255) 
PORT_BACK_DATE TIMESTAMP(23) 
START_TIME TIMESTAMP(23) 
USER_ID VARCHAR(255) 


图 17-2 AIA_C17_LEAVE 表 结构 


@@ 担 示 “ 表 AIA_C17_ LEAVE 会 在 启动 本 章 示例 时 由 Hibernate 自 动 创建。 
单 从 流程 图 上 看 不 出 与 前 面 章节 接触 到 的 请 假 流 程 有 任何 区 别 ， 本 章 内 容 只 是 对 现 有 流程 进行 了 局 部 改造 ， 添 加 了 一 些 监听 器 而 已 ， 稍 后 详解 介绍 。 流 程 文 件 位 于 本 章 示例 (chapter17-jpa) 


的 “src/main/resources/chapter17” 目录 下 ， 读 者 可 以 结合 代码 学 习 。 


17.2.1 ”启动 流程 时 持久 化 JPA 实 体 


对 于 请 假 流 程 ， 在 启动 流程 时 需要 申请 人 填写 表单 ， 在 启动 流程 后 我 们 需要 把 这 些 表 单 内 容 持久 化 到 自 定义 表 AlA_C17_LEAVE， 并 且 把 持久 化 后 得 到 的 JPA 实 例 保存 到 流程 变量 中 ， 这 样 可 以 方便 后 续 
节点 更 改 实体 的 属性 。 


在 流程 中 配置 一 个 启动 (start) 类 型 监听 器 ， 其 作用 是 读 取 用 户 填 写 的 表单 内 容 并 创建 一 个 LeaveJpaEntity ( 见 代 码 清单 17-3) 对 象 并 持久 化 到 数据 库 。 


代码 清单 17-3 ”请 假 实体 


GEntity (name = "AIA C17 LEAVE") 

public class LeaveJpaEntity implements Serializable { 
private Long ia” 

private String processInstancelgd; 
private String userId; 


private Date startTime; 

private Date endTime; 

private Date realityStartTime; 

private Date realityEndTime; 

private Date reportBackDate; 

private Date applyTime; 

private String leaveType; 

private String reason; 

private String deptLeaderApproved; // 部 门 领导 是 否 同意 
private String hrApproved; // 人 事 是 否 同意 
// 省 略 了 getter 和 setter 


有 了 JPA 实 体 还 需要 有 相应 的 实体 管理 器 ( 见 代 码 清单 17-4) ， 由 此 可 以 看 出 这 是 一 个 被 Spring 管 理 的 Bean 对 象 。 在 代码 清单 17-4 中 ，#1 处 注入 了 EntityManager 对 象 ， #2 处 创建 一 个 新 的 JPA 对 
象 ，#3 处 逐个 获取 变量 并 把 值 设 置 到 创建 的 leave 对 象 中 ， 最 后 在 #4 处 持久 化 实体 到 数据 库 。 


代码 清单 17-4 ”请 假 实体 管理 器 


import javax.persistence.EntityManager; 
import javax.persistence.PersistenceContext; 
import java.util.Date; 
@Service 
public class LeaveEntityManager 1{ 
@PersistenceContext #1 
private EntityManager entityManager; 
@Transactional 
public LeaveJpaEntity newLeave (DelegateExecution execution) { 

LeaveJpaEntity leave = new LeaveJpaEntity () ， #2 
leave.setProcessInstanceld (execution.getProcessInstancelId()); #3-S 
leave.setUserlId (execution.getVariable ("applyUserId") .tostring()); 
leave.setStartTime ( (Date) execution.getVariable ("startTime")); 
leave.setEndTime ( (Date) execution.getVariable ("endTime")); 
lJeave.setLeaveType (execution.getVariable ("leaveType") .toString ()); 
leave.setReason (execution.getVariable ("reason") .toString ()); 
leave.setApplyTime (new Date()); #3 一 E 
entityManager.persist (leave); #4 
return leave; 


接 下 来 要 在 流程 启动 时 调用 LeaveEntityManager 的 newLeave (execution) 方法 (execution 是 引擎 的 内 置 变量 ) ， 在 Activiti Designer 中 添加 一 个 流程 启动 监听 器 ， 如 图 17-3 所 示 。 


OO Java class @ Expression OO Delegate expression OO Alfresco execution script ©) Alfresco task script 


Expression Iexecution, setVarliablelleave', leaveEntityManager.newLeavelexecution))} 


Fields 


图 17-3 ”配置 流程 启动 监听 器 


对 应 的 XML 代 码 如 下 : 


<process id="leave-jpa" name=" 请 假 流程 JPA" isExecutable="true"> 
<extensionElements> 
<activiti:executionListener event="start" expression="${execution.setVariable('leave',1leaveEntityManager.newLeave (execution))}"> 
</activiti:executionListener> 
</extensionElements> 


</process> 


这 样 在 流程 启动 后 查询 数据 表 AlA_C17_LEAVE 就 看 到 了 一 条 数据 ， 如 图 17-4 所 示 。 


记录 (AIA_C17_LEAVE) 


START_TIME USER_ID 


2014-04-24 kerrmit 
00:00:00.0 


图 17-4 ”启动 流程 后 插入 的 数据 


同时 观察 一 下 Hibernate 在 控制 台 打 Eh 的 SQL 语 句 ， 其 中 有 如 下 语句 : 


Hibernate: 
insert into aia cl1l7 leave 
(id, apply time, dept leader approved, end time, hr approved, leave type, process instance id, reality end time, reality start time, reason, report back date, start 七 in 
Valtes (六 


除了 自 定义 表 中 的 数据 ， 我 们 再 观察 一 下 变量 表 名 称 为 “leave” 的 变量 ， 如 图 17-5 所 示 。 


a 录 (ACT_RU_VARIABLE) 
ID_ REV _ | TYPE_ NAME_ | PROC_ INST_ID_ | TASK ID BYTEARRAY ID_ | DOUBLE_ | LONG _ 
applyUsearld 5 | | 


leaveType 


5 
starfTime 5 | | 1398268800000 
5 


1398355200000 


me.kafeihi.actviti.chaptarl 7 antity. LeaveJpnaEntity 


图 17-5 ”变量 表 数 据 
从 图 17-5 中 可 以 看 出 有 6 个 不 同类 型 的 变量 ， 其 中 最 后 一 个 变量 的 变量 类 型 字段 (TYPE ) 为 “jpa-entity”， 该 记录 的 TEXT 、TEXT2 字段 分 别 记 录 了 实体 的 完整 类 名 及 主键 1D。 
在 引 警 内 部 有 一 个 专门 处 理 JPA 类 型 的 变量 类 型 类 (org.activiti.engine.impl.variable.JPAEntityVariableType) ， 当 保存 或 读 取 变 量 时 引擎 会 把 JPA 类 型 的 记录 交 给 这 个 类 处 理 ， 当 部 门 领导 签收 了 任 
务 并 打开 办 理 页 面 时 就 会 读 取 任 务 相 关 的 变量 ， 此 时 观察 一 下 控制 台 就 可 以 看 到 有 查询 表 AIA_C17_LEAVE 的 SQL 语句 输出 ， 这 说 明 每 次 读 取 变 量 时 引擎 会 通过 EntityManager 接 口 获取 实体 数据 。 


17.2.2 ”更 改 JPA 实 体 属 性 


上 一 小 节 通 过 在 启动 流程 时 执行 表达 式 实 现 了 创建 数据 记录 ( 见 图 17-4) ， 如 果 用 户 在 办 理 时 填写 了 任务 表单 ， 还 需要 把 改动 的 数据 更 新 到 实体 中 ， 例 如 : 
.部门 领导 审核 节点 完成 时 保存 审批 意见 。 

.人事 审核 节点 完成 时 保存 审批 意见 。 

* 销假 节点 完成 时 保存 员工 填写 的 实际 请 假日 期 。 

现在 读者 的 脑海 中 应 该 是 这 样 想 的 : “用 户 任务 完成 时 无 非 就 是 该 任务 上 添加 一 个 complete 类 型 的 监听 器 而 已 ”。 


例如 在 “部 门 领导 审核 ”节点 要 更 新 实体 的 属性 ， 可 以 参照 图 17-6。 


Type 加 Java class (=) Expression OO Delegate expression 加 Alfresco execution script OO Alfresco task script 
Expression $leave.setDeptLeaderApproved(ldeptLeaderApproved)} 


Fields 


Field name |String value |Expression | 


图 17-6 ”部 门 领导 审核 节点 添加 任务 完成 监听 器 


对 应 的 XML 如 下 : 


<userTask id="deptLeaderAudit" name=" 部 门 领导 审批 " activiti:candigdateGroups="deptLeader"> 
<extensionElements> 
<activiti:taskListener event="complete" expression="$ {leave.setDeptLeaderApproved (deptLeaderApproved) }"></activiti:taskListener> 
</extensionElements> 
</userTask> 


此 时 以 部 门 领导 身份 登录 系统 后 会 看 到 一 条 待 办 任务 ， 签 收 并 打开 表单 页 面 后 如 图 17-7 所 示 ， 在 “审批 意见 ”处 选择 “同意 ”， 然 后 单 击 “ 完 成 任务 ”按钮 ， 此 时 观察 表 AlIA_C17_LEAVE 的 数据 会 发 现 
字段 “DEPT_LEADER_APPROVED” 的 值 为 “true”， 表 示 部 门 领导 节点 的 审批 意见 更 新 成 功 了 。 


请 假 类 型 : 


请 假 开 始 日 期 : 


请 假 结束 日 期 : 


请 假 原因 : 


审批 意见 : 


w 完 万 任务 


图 17-7 ”部门 领导 审核 任务 表单 


现在 读者 可 能 有 疑问 了 ， 更 改 了 属性 后 为 什么 没有 调用 EntityManager 的 持久 化 方法 却 能 持久 化 对 象 到 数据 表 ?” 这 是 因为 配置 了 事务 管理 器 (参考 本 章 源码 的 applicationContext.xml 文 件 中 名 称 为 
transactionManager 的 Bean 对 象 ) ， 由 Spring 接管 了 引擎 的 事务 ， 当 然 我 们 更 改 的 实体 也 在 被 监管 的 范围 内 ， 所 以 在 更 改 实体 属性 并 提交 事务 时 就 自动 执行 了 数据 库 的 update 操 作 。 观 察 任 务 完成 时 控制 
台 打印 的 SQL 语句 如 下 所 示 : 


Hibernate: 

update 
aia cl7 leave 

set 
apply time=?, 
dept leader approved=?, 
end time=?, 
hr approved=?, 
leave type=?, 
process instance id=?, 
reality end time=?, 
reality start time=?, 
reason=?,) 
report back date=?, 
start time=?, 
user id=? 

where 
igd=? 


人 事 审批 节点 与 部 门 领导 审核 节点 类 似 ， 只 是 更 改 的 属性 不 同 而 已 ， 读 者 可 以 自行 试验 。 


段 “HR APPROVED” 值 为 “true”。 


下 面 给 出 了 相应 的 XML 配置 ， 在 任务 完成 后 AIA_C17_LEAVE 表 的 数据 如 图 17-8 所 示 ， 字 


<userTask id="hrAudit"” name=" 人 事 审批 " 
activiti:candidateGroups="hr"> 
<extensionElements> 


<activiti:taskListener event="complete" expression="${leave.setHrApproved 


</activiti:taskListener> 
</extensionElements> 
</userTask> 


(hrApproved) }"> 


记录 (AIA_C17_LEAVE) 


2014-04-24 
00:20:00.337 


图 17-8 ”人 事 审批 通过 后 数据 库 变化 


当 任 务 到 达 “ 销 假 ” 节 点 时 ， 处 理 方式 类 似 ， 把 用 户 填写 的 实际 请 假日 期 更 新 到 数据 库 ， 对 应 的 XML 如 下 ， 任 务 办 理 界面 如 图 17-9 所 示 ， 任 务 完成 后 数据 库 状态 如 图 17-10 所 示 。 


<userTask id="reportBack"” name=" 销 假 " activiti:assigqnee="${leave.userId}"> 


eh 


<extensionElements> 


<activiti:taskListener event="complete" expression="${leave.setReportBackDate (reportBackDate) }"></activi 


<activiti:taskListener event="complete" expression="${leave.setReal 
<activiti:taskListener event="complete" expression="${leave.setReal 


</extensionElements> 
</userTask> 


ityStartTime (reali 


ity] 


EndTime (realityEndTime) }"></ac 


ti 


:taskListener> 


tyStartTime) }"></ac 


tiviti:taskListener> 


zd 


ti 


:taskListener> 


请 假 类 型 : 


请 假 开 始 日 期 : 


请 假 结束 日 期 : 


请 假 原因 : 


(实际 ) 请 假 开 始 日 期 : 


(实际 ) 请 假 结 束 日 期 : 


销假 日 期 : 


2014-04-24 


2014-04-25 


公休 2 天 


2014-04-24 


2014-04-25 


2014-04-28 


图 17-9 ”销假 节点 任务 表单 


过 (AIA C17 LEAVE) 
Jo ome mee err pen enowen ea rue Wm renowes ae mre mocea ner 


2014-04- true 


00:20:00.337 25 
00:00:00.0 


REALITY_END_TIME REALITY_START_TIME REASON | REPORT_BACK _DATE START_TIME USER_ID 
2014-04-24 00:00:00.0 公休 2 天 2014-04-28 00:00:00.0 2014-04-24 | kermit 


图 17-10 ”销假 任务 完成 后 的 数据 


17.2.3 ”清理 历史 表单 数据 


到 目前 为 止 我 们 已 经 成 功 把 数据 存储 方式 从 “ 行 ” 转 换 成 “ 列 ”， 不 过 现在 有 一 个 问题 需要 解决 ， 要 把 已 结束 流程 的 表单 数据 清理 掉 以 减少 数据 量 ， 从 而 提高 引擎 访问 数据 库 的 性 能 。 可 以 在 流程 中 配 
置 一 个 流程 完成 监听 器 来 清理 历史 表单 数据 ， 我 们 知道 表单 数据 保存 在 ACT_HI_DETAIL 表 中 ， 在 流程 结束 时 执行 删除 动作 即 可 。 


图 17-11 展 示 了 添加 的 流程 结束 监听 器 ， 执 行 一 个 Delegate Expression。 


芽 Markers 国 Properties 器 国 Console 加 Progress Jo JUnit 


| i Execution listeners: 


Listeners Listener implementation iType 


a = 


SIexecution. setVariable('leave'", ,lea... expression 


© Java dlass OO Expression ® Delegate expression ©) Mlfresco execution script (© Alfresco task script 


Delegate expression | WleaveProcessEndListener} 


图 了 7- 人 流程 的 结 监 听 器 


对 应 的 XML 如 下 : 


<activiti:executionListener event="end" 
delegateExpression="${leaveProcessEndListener}"> 
</activiti:executionListener> 


名 称 为 “leaveProcessEndListener” 的 Bean 对 象 具体 实现 见 代 码 清单 17-5， 其 主要 是 行 了 一 条 SQL 语 句 ， 从 ACT_HI_DETAIL 表 中 删除 了 和 当前 流程 相关 的 数据 


代码 清单 17-5 ”请 假 流程 结束 时 


@Service 
GTransactional 
public class LeaveProcessEndListener implements ExecutionListener { 
QPersistenceContext 
private EntityManager entityManager; 
QOverride 
public void noti Fy (Delegater Execution execution) throws Exception { 
String process] mstance ld = exXxecution.getProcessInstanceId () ; 
String Bol "delete from act hi detail where proc inst id = ? and type = ?"7 
int i = en ho ee createNativeQuery (sql) 本 加 
.SetParameter (1, PrOGeSS] [Instanceld) 
.SetParameter (2, "FormProperty") 
.executeUpdate () 


logger.debug ("清理 了 {} 多 条 历史 表单 数据 "，1) ; 


} 


17.3” 本章 小 结 


本 章 详细 讲解 了 引擎 与 JPA 的 集成 ， 可 以 把 动态 表单 的 流程 数据 保存 到 自 定义 的 表 中 ， 这 样 可 以 把 原本 “无 结构 ”的 数据 转换 为 “有 结构 ”的 数据 ， 方 便 数 据 的 查询 、 使 用 。 


第 18 章 ”集成 ESB 


ESB (Enterprise Service Bus) ， 即 企业 服务 总 线 ， 可 用 于 集中 管理 企业 内 部 应 用 对 外 的 交互 ， 提 供 对 内 部 应 用 的 协议 转换 、 管 理 、 监 控 、 审 计 、 分 析 等 功能 。 除 了 对 单个 服务 的 管理 功能 外 ，ESB 还 
可 以 把 企业 内 部 各 个 分 散 的 功能 封装 成 一 个 整体 服务 ， 这 对 于 服务 调用 者 来 说 只 需要 关注 一 个 接口 即 可 。 


目前 比较 流行 的 ESB 平 台 有 Camel、Mule、ServiceMix、Spring Integration 等 ， 这 些 都 实现 了 EIP (Enterprise Integration Patterns， 企 业 整 合 模式 ) 。 本 章 将 针对 Camel、Mule 分 别 介 绍 如何 与 
Activiti 集 成 。 


18.1 


Camel 简 介 与 快速 入 门 


Camel 是 由 Apache 开 源 组 织 使 用 Java 语 言 开 发 的 一 个 强大 的 基于 规则 的 路 由 及 媒介 引擎 ， 采 用 URI 的 方式 来 描述 多 个 需要 整合 的 组 件 。 
由 规则 。 下 面 的 代码 就 是 一 个 简单 的 路 由 示例 ， 其 功 


from ("file:/tmp/folder1") 


“to 


(© 


file: /tmp/f 


开发 人 员 可 以 使 用 DSL (Domain Specific Language) 配置 路 
能 是 把 /tmpy/folder1 目 录 的 文件 转移 到 /tmpy/folder2 目 录 。 


older2");}; 


有 关 Camel 的 资料 可 以 访问 官方 网 站 http://camel.apache.org 来 了 解 。 


本 节 介 绍 一 个 基于 Camel 的 简单 例子 一 一 HelloCamel， 以 便 快速 入 门 。 


熟悉 Camel 的 读者 可 以 跳 过 本 节 直 接 学 习 下 一 小 节 。 


个 证 示 本 章 的 相关 代码 可 以 在 本 书 源 代码 chaptef18-esb 模 块 的 chaptet18 目 录 中 找到 。 


使 用 Came| 需 要 先 在 Maven 的 pom.xml 文 件 中 添加 依赖 定义 ， 代 码 如 下 : 


<dependency> 


<groupId>org.apache.camel</groupId> 


<artifactId>camel-spring</artifactI 


Q> 


<version>2.11.4</version> 


</dependency> 


Camel 的 核心 是 路 由 (Route) 。 路 由 可 以 用 XML 的 方式 配置 ， 也 可 以 自 定义 一 个 继承 自 RouteBuilder 接 口 的 Java 类 注册 到 CamelContext 对 象 中 。 


本 书 中 的 Camel 路 由 均 使 用 Java 类 的 方式 定义 。 


在 代码 清单 18-1 中 定义 的 路 由 用 于 判断 请 假 天 数 是 否 超 过 3 天 ， 并 把 结果 设置 到 名 称 为 “leave” 的 Bean 对 象 中 。Bean 的 定义 见 代 码 清单 18-2， 针 对 代码 清单 18-1 的 路 由 功能 的 验证 见 代码 清单 18-3。 


代码 清单 18-1 


Came| 路 由 实现 的 请 假 逻 辑 


public class CamelLeaveRoute extends RouteBuilder { 
QOverride 
public void configure() throws Exception { 
from("direct:start") // 路 由 URI 
.1og (LoggingLevel .INFO, "接收 到 消息 : ${in.body}") 
.choice () 
.when (simple ("${in.body[days]} > 3")) // 路 由 条 件 
.1og ("用 户 ${body[userId]} 请 假 天 数 超过 3 天 ") 
.beanRef ("leave",， "setResult (true)") // 调用 Bean 的 setResult 方 法 
.enaqChoice () 


代码 清单 18-2 CamelLeaveBean 类 


ements Ser 


public class CamelLeaveBean impl] 
ult = fal 


private Boolean res 


Ia 


Se7 


// 省 略 getter 和 setter 


ializable { 


代码 清单 18-3 ”验证 Camel 路 由 实现 的 请 假 逻 辑 


public class CamelTest { 


QTest 

public void testCamelForBean() throws Exception 1{ 
JndiContext context = new JndiContext () ， 
CamelLeaveBean leave = new CamelLeaveBean () ， 
context.bind("leave"，leave); // 把 Bean 对 象 绑 定 到 CamelContext 中 
CamelContext camelContext = new DefaultCamelContext (context); 
camelContext .addRoutes (new CamelLeaveRoute()); // 把 路 由 注册 到 CamelContext 
camelContext.start () ， 
ProducerTemplate tpl camelContext .createProducerTemplate () ， 
// true 
tpl.sendBody ("direct:start", Collections.singletonMap ("days", 2)); #1-S 
assertrFalse (leave.getResult ()); #1 一 
// false 
tpl.sendBody ("direct:start", Collections.singletonMap("days ", 5)); #2-5S 
assertTrue (leave.getResult () ) ， #2-E 
camelContext.stop(); 


代码 清单 18-3 中 的 #1-S$、#2-S 处 分 别 发 送 了 请 假 ? 天 、5 天 的 路 由 请 求 ， 运 行 单元 测试 后 ，#1-E、 


在 本 书 开 头 就 强调 过 ，Activiti 不 仅 是 一 个 流程 引擎 ， 确 切 地 说 更 是 一 个 BPM 平 台 。 
数 大 于 3 天 由 部 门 经 理 审批 ， 否 则 由 直接 领导 审批 。 


18.2 ”在 流程 中 调用 Camel 


#2- 忆 均 验 证 通过 ， 这 说 明 路 由 ( 见 代 码 清单 18-1) 可 以 提供 正确 的 功能 。 


例如 ， 图 18-1 的 流程 图 中 集成 了 Camel 任 务 来 调用 Camel 路 由 从 而 影响 流程 的 走向 ， 该 流程 的 作用 是 : 申请 的 假期 天 


请 假 天 数 大 于 3 


3 
部 门 经 理 审批 


滨 
调用 Camel 服 务 


请 假 天 数 小 于 3 


EN 


图 18-1 集成 了 Camel 任 务 的 流程 图 
BPMN 2.0 规 范 中 没有 单独 的 Camel 任 务 ， 在 第 4 章 中 介绍 Camel 任 务 时 就 说 明了 Camel 任 务 是 基于 ServiceTask 进 行 扩展 的 。 一 个 Camel 任 务 的 XML 定义 如 下 
<serviceTask id="invokeCamel" name="Came] Task" 


activiti:type="camel"></serviceTask> 


“请 假 天 数 大 于 3 天 ”的 输出 流 条 件 为 9{fdeptLeaderAudit}， 


<sequenceFlow ig=" 


Filow2™ name=" 训 
<conditioni 


“请 假 天 数 小 于 3 天 ”的 输出 流 条 件 为 ${! deptLeaderAudit}， 相 关 XML 如 下 : 
§ 假 天 数 大 于 3 天 " sourceRe: 
Expression xsi:type="tFormall 


<![CDATA[$ {deptLeaderAudit}]]> 
</conditionExpression> 
</sequenceFlow> 
<userTask id="directly] 
<sequenceFlow iqd=" 
<condition] 


f="invokeCamel" targetRe 
Expression"> 


eaderAudit 


t" name=" 直 接 领 导 审 批 "/> 

flow3" name=" 请 假 天 数 小 于 3 天 " sourceRe 
Expression xsi:type="tFormalExpression"> 
<![CDATAI[${!deptLeaderAudit}]]> 
</conditionExpression> 
</sequenceFlow> 


"deptLeaderAudit"> 


f="invokeCamel" targetRe 


f="directlyLeaderAudit"> 


从 条 件 可 以 看 出 ， 需 要 在 运行 时 向 流程 实例 提供 “deptLeaderAudit 
18.2.1 


Camel 依 赖 及 配置 


文明 |， 


确切 地 说 应 该 是 由 “调用 Camel 服 务 ” 这 个 任务 提供 ， 这 也 就 是 我 们 学 习 的 目标 。 
提供 的 自动 扫描 功能 ， 配 置 如 下 : 


<camelContext id="camelContext" 


在 本 书 源 代码 chapter18-esb/src/test/resources/chapter18/applicationContext.xml 文 件 中 用 Spring 代 理 了 Activiti 引 擎 ， 其 中 除了 定义 和 Activiti 有 关 的 必要 配置 之 外 ， 还 添加 了 camel-spring 模 块 
XI 


<packageScan> 


Ins="http://camel.apache.org/schema/spring"> 
<package> 
me .Ka 


feitu.activiti.chapterl8.esb.camel .activiti 
</package> 

</packageScan> 

</camelContext> 


以 上 配置 可 以 在 初始 化 CamelContext 时 把 包 me.kafeitu.activiti.chapter18.esb.camel.activiti 中 的 路 由 类 (继承 RouteBuilder 类 ) 注册 到 CamelContext 对 象 中 。 
另外 还 需要 添加 Activiti 的 Camel 模 块 ， 其 Maven 依 赖 定义 如 下 : 


<dependency> 
<groupId>org.apache.camel</groupId> 
<artifactId>camel-spring</artifactId> 
<version>2.11.4</version> 
</dependency> 
<dependency> 
<groupId>org.activiti</groupId> 
<artifactId>activiti-camel</artifactId> 
<version>${activiti.version}</version> 
</dependency> 


全 注意 在 使 用 Activiit 5.15 与 camel-spting 2.12.x 整 合 时 会 遇 到 Camel 内 部 对 和 象 org.apache.camel.impl.DefaultMessageHistory 不 能 序列 化 的 问题 ， 所 以 本 书 使 用 的 是 Camel 2.11.x， 未 来 Activiti 的 Camel 模 块 应 该 
18.2.2 定义 Camel 路 由 


结果 以 变量 的 形式 回 传 给 流程 实例 。 


activiti-camel 模 块 提 供 了 Came 上 与 Activiti 通 信 的 桥梁 ， 由 Activiti 触 用 Camel 任 务 后 执行 相符 的 路 由 ， 同 时 可 以 选择 把 流程 相关 的 变量 传递 给 路 由 ， 在 路 由 处 理 结束 后 还 可 以 有 选择 性 地 把 路 由 产生 的 
activiti-camel 模 块 定义 了 “activiti” 类 型 的 路 由 URI 协 议 ， 一 


from("activiti://leaveWwit 


个 典型 
.to("log: catch rout 


~ 二 


thCamel :invokeCamel? 


的 路 由 格式 如 下 ， 表 18-1 列 出 了 对 URI 的 解释 。 


fooVar=bar") 
te days: ${property.days}") 


表 18-1 activiti-camel 模 块 提供 的 URI 协 议 


属性 名 称 属性 说 明 


activiti:// 协议 开头 

leave WithCamel 流程 定义 的 KEY 
invokeCamel 流程 中 Camel 服务 的 任务 ID 
fooVar=bar 路 由 URI 的 参数 


代码 清单 18-4 列 出 了 和 流程 结合 的 路 由 配置 相关 代码 ， 稍 后 会 介绍 其 他 几 种 定义 方式 。 


代码 清单 18-4 CamelWithActivitiLeaveRoute.java 


public class CamelWithActivitiLeaveRoute extends RouteBuildqer { 

public void configure() throws Exception 
from("activiti://leaveWithCamel:invokeCamel") #1 
.1og (LoggingLevel .INFO, "接收 到 消息 ; ${property.days}") 


.1og (LoggingLevel.INFO,，"Camel 路 由 中 接收 到 流程 I 


己 


$s{property." + ActivVitiProdqucer. PRO ESS ID PROPERTY + "}") 
.Choice() .when (simple("${property.days} > 3")) #2 
.SetProperty ("deptLeaderAudit",simple ("true", Boolean.class)) #3 
.otherwise () .setProperty ("deptLeaderAudit", simple ("false", Boolean.class)); #4 
.endChoice() .setBody() .properties (); #5 


代码 清单 18-4 的 #1 处 声明 了 路 由 的 URI，#2 处 使 用 流程 变量 作为 条 件 判断 的 依据 ，#3、#4 处 设置 变量 “deptLeaderAudit” 的 值 ，#5 处 路 由 中 设置 的 属性 作为 响应 Body 对 象 的 值 ， 这 样 在 流程 中 就 可 
以 使 用 在 路 由 中 设置 的 属性 ， 这 一 切 都 由 Activiti 的 Camel 模 块 来 完成 。 
18.2.3 ”执行 单元 测试 

一 切 都 准备 好 了 ， 现 在 可 以 验证 Activiti 与 Camel 的 整合 是 否 可 以 提供 我 们 预期 的 功能 了 。 代 码 清单 18-5 列 出 了 配套 的 单元 测试 来 帮 我 们 验证 流程 的 执行 结果 。 


代码 清单 18-5 ”Activiti 与 Camel 整 合 的 单元 测试 类 ActivitiWithCamelTest 


@QContextConfiguration ("classpath:chapter18/applicationContext .xml") 
public class ActivitiWwithCamelTest extends SpringActivitiTestCase { 
QDeployment (resources = {"chapter18/leaveWithCamel .bpmn"}) 
public void testCamel() throws Exception { 
Map<String, Object> vars = new HashMap<String, Object>(); 
vars.put ("days", 5); // 设置 请 假 天 数 #1 
ProcessInstance ProcessInstance = runtimeService 
.StartProcessInstanceByKey ("leaveWithCamel", vars); 
assertNotNull (processInstance); 
Task task = taskService.createTaskQuery() .singleResult ()，; 
assertEquals ("部 门 经 理 审批 "，task.getName () )，; 


18.2.4 ”URI 输 入 参数 


在 代码 清单 18-4 中 ，#1 处 的 from() 方 法 的 参数 是 一 个 标准 的 URI， 如 果 要 干预 Camel 组 件 的 功能 ， 需 要 传递 一 些 参数 ， 本 节 将 一 一 介绍 路 由 URI 中 支持 的 参数 ， 包 括 输入 参数 和 输出 参数 两 类 。 完 整 代码 
可 参考 本 书 源 代码 文件 chapter18-esb/src/main/java/xxx/CamelWithActivitiLeaveRoute.java 在 该 文件 中 启用 一 种 参数 配置 方式 后 运行 代码 清单 18-5 所 示 的 测试 代码 均 能 通过 单元 测试 。 


1.copyVariablesFromProperties 


默认 属性 ， 该 属性 可 以 把 Activiti 变 量 复制 成 Ccamel 属 性 ， 在 路 由 中 可 以 使 用 像 ${property.foo} 这 样 的 表达 式 获 取 该 属性 的 值 ， 与 代码 清单 18-4 中 的 setBody().properties(0 功 能 等 价 。 


from("activiti://leaveWithCamel:invokeCamel 
?copyVariablesFromProperties=true") 


.Choice() 
.when (simple ("${property.days} > 3")) 


.SetProperty ("deptLeaderAudit", 
simple ("true", Boolean.class)) 


.otherwise () 
.SetProperty ("deptLeaderAudit", 
simple ("false", Boolean.class)); 


除了 可 以 使 用 URI 参 数 的 形式 启用 该 功能 外 ， 还 可 以 在 流程 文件 中 配置 一 个 Camel 行 为 实现 类 ， 效 果 与 参数 功能 相同 。 


<serviceTask id="serviceTaskl" activiti:type="camel"> 
<extensionElements> 
<activiti:field name="camelBehaviorClass" 
stringValue="org.activiti.camel.impl. 
CamelBehaviorCamelBodyImpl" /> 


i 


</extensionE 
</serviceTask> 


ements> 


2.copyCamelBodyToBody 


只 把 名 称 为 “camelBody” 的 Activiti 变 量 复制 成 Camel 消 息 体 ， 如 果 camelBody 的 值 是 Map 对 象 ， 在 路 由 中 可 以 通过 $fbody[foo]} 获 取 属 性 的 值 ， 如 果 是 纯 字 符 ， 可 以 使 用 $fbody} 获 取 。 


from("activiti://leaveWithCamel:invokeCamel?copyCamelBodyToBody=true&copyVariablesFromProperties=true") 
.Choice() .when (simple("${body[days]} > 3")) 
.SetProperty ("deptLeaderAudit", 
simple ("true", Boolean.class)) 
.Otherwise () .setProperty("deptLeaderAudit", 
Slimple("false"，Boolean.class) )， 


需要 特别 说 明 一 点 ， 要 人 在 流 程 中 传递 一 个 名 称 为 “camelBody” 的 变量 ， 否 则 路 由 获取 不 到 body 的 属性 ， 把 代码 清单 18-5 中 的 #1 处 蔡 换 成 如 下 代码 : 


vars.put ("camelBody", Collections.singletonMap ("days", 5)); 


除了 使 用 URI 参 数 的 形式 启用 该 功能 外 ， 还 可 以 在 流程 文件 中 配置 一 个 Camel 行 为 实现 类 ， 效 果 与 参数 功能 相同 。 


<serviceTask id="serviceTaskl" activiti:type="camel"> 
<extensionElements> 
<activiti:field name="camelBehaviorClass" 
stringValue="org.activiti.camel.impl. 
CamelBehaviorCamelBodyImpl" /> 


</extensionFElements> 
</serviceTask> 


3.copyVariablesToBodyAsMap 


与 属性 copyCamelBodyToBody 功 能 类 似 ， 但 是 这 个 属性 开启 后 会 把 Activiti 所 有 变量 赋值 到 一 个 Map 对 象 中 作为 Camel 的 消息 体 。 


from("activiti://leaveWithCamel:invokeCamel?copyVariablesToBodyAsMap=true&copyVariablesFromProperties=true") 
.Choice() .when (simple("${body[days]} > 3")) 
.SetProperty ("deptLeaderAudit", 
simple ("true", Boolean.class)) 
.Otherwise () .setProperty ("deptLeaderAudit", 
simple ("false", Boolean.class)); 


18.2.5 ”URI 输 出 参数 
1. 默 认 配 置 
如 果 Camel 消 息 体 是 一 个 Map 对 象 ， 那 么 路 由 执行 结束 后 会 把 Camel 的 每 一 个 属性 复制 成 Activiti 流 程 实例 变量 ， 否 则 把 整个 Camel 消 息 体 作为 Activiti 变 量 “camelBody” 的 值 。 


2.copyVariablesFromProperties 


该 属性 可 以 将 Camel 属 性 以 相同 的 名 称 复制 成 Activiti 变 量 。 


from("activiti://leaveWithCamel:invokeCamel?copyVariablesFromProperties=true") 
.Choice() .when (simple("${property.days} > 3")) 
.SetProperty ("deptLeaderAudit", 
simple ("true", Boolean.class)) 
.Otherwise () .setProperty ("deptLeaderAudit", 


simple ("false", Boolean.class)); 


3.copyVariablesFromHeader 


此 属性 的 功能 和 copyVariablesFromProperties 类 似 ， 不 同 的 是 此 属性 是 从 Header 读 取 而 不 是 从 Properties 中 读 取 。 


from("activiti://leaveWithCamel:invokeCamel?copyVariablesFromProperties=true") 

.Choice() .when (simple("${property.days} > 3")) 

.SetHeader ("deptLeaderAudit", 
simple ("true", Boolean.class)) 

.Otherwise () .setHeader ("deptLeaderAudit", 
simple ("false", Boolean.class)); 


4.copyCamelBodyToBodyAsString 


CopyCamelBodyToBodyAsstring 的 功能 和 默认 配置 的 功能 相同 ， 但 是 当 Camel 消 息 体 不 是 Map 对 象 时 先 把 消息 转换 成 字符 串 再 设置 到 “camelBody” 变量 中 。 


18.3 ”异步 Camel 任 务 


| 和 开 少 


如 果 Camel 任 务 执 行 时 间 比 较 长 ， 可 以 把 异步 功能 打开 ， 并 且 在 Camel 任 务 后 面 添加 一 个 Receive Task 接 收 Camel 任 务 执行 完成 的 通知 节点 。 图 18-2 展 示 了 一 个 异步 Camel 任 务 。 


有 mel 中 > , 待 Camel 任 务 
Camel 任 务 ne 


图 18-2 ”异步 Camel 任 务 流程 图 


图 18-2 所 示 流 程 对 应 的 XML 如 下 : 


<serviceTask id="asyncCamelTask" name="Camel 任 务 " 
activiti:async="true"></serviceTask> 
<receiveTask id="receiveAsyncCamel" 
name=" 等 待 Camel 任 务 完成 "></receiveTask> 
<sequenceFlow id="flow2" sourceRef="asyncCamelTask" 
targetRef="receivetaskl"></sequenceFlow> 


当 执 行 到 Camel 任 务 时 流程 实例 会 等 待 接收 信号 (Signal) ， 可 以 通过 下 面 的 代码 由 Camel 向 Activiti 引 擎 发 送信 号 。 


from("activiti:camelAsyncProcess:asyncCamelTask") 
.to("activiti: camelAsyncProcess:receiveAsyncCamel ") ， 


也 可 以 使 用 Activiti 的 标准 API 发 送信 号 恢复 流程 的 执行 状态 : 


runtimeService.signal (executionId); 


18.4 在 Camel 中 启动 流程 


通过 以 上 内 容 我 们 学 习 了 如 何 整合 Camel 与 Activiti， 以 及 两 者 如 何 通 信 ， 但 是 这 些 都 是 建立 在 流程 实例 已 经 启动 的 状态 下 。 本 节 将 介绍 如 何在 Camel 中 启动 Activiti 流 程 ， 如 代码 清单 18-6 所 示 。 


代码 清单 18-6 ”在 Camel 中 启动 Activiti 流 程 的 路 由 类 


public class StartProcessByCamelRoute ex 


QOverride 


public void con 


figure() throws Except 


from("activiti://masterPprocess:st 
.to("activiti:camelSubProcess");}; 


// 通过 camel 启 动 


} 


图 18-3 展 示 了 两 个 流程 ， 分 别 为 masterProcess (主流 程 ) 和 camelSubProcess ( 子 流程 ) ， 对 应 的 单元 测试 如 下 : 


QDeployment (resources = 1 
"chapter18/masterProcess .bpmn", 


ProcessIlnst 


"chapter] 
public void testStartProcessS] 


tends RouteBuilder { 


tion { 
tartSubProcess") 


) 
流程 URI 只 需要 传递 两 个 参数 即 可 


18/camelSubProcess .bpmn"}) 
ByCamel () throws 


Exception { 


assertNotNull (processInstance); 


// 检查 子 流程 是 否 已 启动 


Processlnst 


.ProcessDe 
.Singl 


Creak 


eResult () ， 


assertNotNull (subProcess); 


ss masterProcess 2 


“Us camelSubProcess 中 | 


18.5 ”集成 Mule 


tance ProcessInstance = runtimeService 
.StartProcessInstanceByKey ("masterProcess");}; 


tance subProcess = runtimeService 
eProcessIinstanceQuery () 
finitionKey ("camelSubProcess") 


Camel 任 务 


Recelve ask 


图 18-3 ”在 Camel 中 局 动 流程 的 相关 流程 定义 


Mule 和 Camel 类 似 ， 都 是 轻 量 级 的 ESB 平 台 实 现 ， 提 供 了 一 个 以 EIP 为 基础 的 框架 ， 可 以 把 各 种 协议 、 第 三 方 框架 的 实现 等 方便 地 集成 到 Mule 中 ，Mule 团 队 也 针对 Activiti 提 供 了 一 个 专门 的 模块 用 于 
建立 两 者 的 通信 桥梁 。 


本 节 的 Maven 依 赖 配置 可 以 从 chapter18-esb 模 块 的 pom.xml 文 件 中 查看 ， 由 于 配置 较 多 这 里 不 再 列举 。 Mule 版 本 号 : 3.3.0; Spring 版 本 号 : 3.2.7.RELEASE; Mule-Activiti 组 件 版 本 号 : 3.2.0。 


18.5.1 Mule 快 速 入 门 


与 讲解 Camel 类 似 ， 为 了 照顾 不 熟悉 Mule 的 读者 ， 这 里 先 介绍 一 些 基础 知识 ， 让 大 家 快速 入 门 ， 然 后 再 介绍 Activiti 与 Mule 的 集成 。 


Mule 的 读者 可 以 跳 过 本 小 节 。 


camel 中 的 路 由 在 Mule 中 称 为 Flow， 这 些 Flow 定 义 在 一 个 XML 文件 中 ， 可 以 定义 Flow 的 访问 路 径 、 调 用 的 服务 以 及 请 求 内 容 等 信息 。 代 码 清单 18-7 列 出 了 人 入门 示 例 的 XML 配置 ， 该 文件 为 


chapter18-esb/src/test/resources/chapter18/mule/mule-standlone-config.xml, 


代码 清单 18-7 mule-standlone-config.xml 


<mule xmlns="http://www.muleso 


XMmMINS:XxsS 


xmlns:vm="htt 


ft .org/schema/mule/core" 


i="http://www.w3.o0rg/2001/XMLSchema-instance" 


tp://www.muleso 
xsi:schemaLocation="http://www.muleso: 
http://www.mulesoft.org/schema/mule/core/3. 
ft .org/schema/mule/vm 


hi 


<flow name="HelloM 


http://www.muleso 
t .org/schema/mule/vm/3.1] 


ttp://www.mulesof 
ule"> 


ft .org/schema/mule/vm" 
ft .org/schema/mule/core 
1/mule.xsd 


| /mule-vm.xsd"> 


<vm: inbound-endpoint path="helloMule" exchange-pattern="request-response" /> 
<Component class="me.kafeitu.ac ] 
<method-entry-point-resolve 
<include-entry-point method=" 


r> 


tiviti.chapterl8.esb.mul 


(= 


eaveMule Service"> 


'ijsDeptLeaderApproved"/> #3 


#1 
#2 


</method-entry-point-resolver> 
</component> 
</flow> 
</mule> 


代码 清单 18-7 是 一 个 比较 简单 的 Mule 配 置 文件 ，XML 头 部 要 引入 必要 的 Scheme: #1 处 的 vm 是 Mule 的 一 种 协议 ， 用 参数 “path” 定 义 访问 路 径 ， 这 样 我 们 通过 vm://helloMule 就 可 以 访问 到 该 服 
务 ; #2 处 定义 了 一 个 组 件 并 指定 了 class 属 性 ， 表 示 当 访问 该 Flow 时 会 执行 配置 的 类 文件 并 调用 #3 处 定义 的 “isDeptLeaderApproved” 方法 。 


代码 清单 18-7 中 #2 处 的 Java 文 件 定义 了 一 个 简单 的 服务 ， 见 代码 清单 18-8 所 示 ，LeaveMuleService 类 只 定义 了 一 个 方法 ， 接 收 一 个 名 称 为 days 的 参数 ， 然 后 返回 与 3 比较 大 小 后 的 结果 ，。 


代码 清单 18-8 LeaveMuleService.java 


public class LeaveMuleService { 
public boolean isDeptLeaderApproved (Integer days) { 
return days > 3; 


} 
} 


定义 了 XML 配置 文件 及 服务 类 ， 现 在 我 们 可 以 来 检验 一 下 这 个 简单 的 M ule 服 务 能 否 提供 预期 的 结果 。 
和 Camle 类 似 ，M ule 也 需要 先 创 建 上 下 文 对 象 (Context) 才能 调用 Mule 公 开 的 API。 代 码 清单 18-9 列 出 了 一 个 Junit 单 元 测试 类 用 于 验证 Mule 服 务 的 执行 结果 。 


代码 清单 18-9 ”Mule 入 门 单元 测试 类 HelloMuleTest.java 


public class HelloMuleTest { 

@Test 

public void testMule () throws Exception { 
MuleContext muleContext = new DefaultMuleContextFactory() // 初始 化 Context 
.CreateMuleContext ("chapterl8/mule/mule-standlone-config.xml"); 
muleContext.start (); 
MuleClient muleClient = new DefaultLocalMuleClient (muleContext); 
Integer days = 5; // 定义 请 假 天 数 ， 结 果 应 该 返回 true 
MuleMessage message = muleClient.send("vm://helloMule"， // 服务 协议 URI 
new DefaultMuleMessage (days, muleContext)); 
assertNotNull (message.getPayload()); 
Boolean result = (Boolean) message.getPayload(); 
assertTrue (result); 


单元 测试 执行 通过 说 明定 义 的 Mule 服 务 可 以 正常 提供 功能 ， 接 下 来 继续 学 习 如 何在 Activiti 流 程 中 调用 Moule 服务 。 


18.5.2 ”Mule、Spring 与 Activiti 集 成 


在 开始 介绍 这 一 小 节 之 前 ， 需 要 先 了 解 一 人 Mule 与 Spring 如 何 集成 。 因 为 示例 代码 中 使 用 Spring 代理 Activiti 引 警 (这 也 是 大 多 数 开 发 人 员 采 用 的 方式 ) 。Mule 与 Activiti 均 提供 了 Spring 模 块 ， 所 以 我 
们 使 用 Spring 作 为 两 者 的 黏合 剂 。 


Mule 与 Spring 都 可 以 作为 Bean 容 器 使 用 ， 如 果 系 统 环 境 以 Mule 为 主 ， 可 以 把 Mule 作 为 主 容器 ， 然 后 引入 (import) Spring 的 bean 对 象 ; 如 果 系统 环境 以 Spring 为 主 ， 可 以 把 Spring 作 为 主 容器 ,在 
创建 MuleContext 对 象 时 引入 Mule 的 配置 文件 。 选 择 哪 种 配置 方式 可 以 根据 开发 环境 决定 。 


下 面 列 出 了 chapter18-esb/src/test/resources 目 录 的 树 状 结构 ， 根 据 选 择 的 主 容器 划分 了 目录 ， 以 便 读者 理解 参考 。 


mule-master 
mule-master .xml // Mule 作 为 主 容器 
spring-activiti-lesser.xml // Spring 配 置 被 加 载 (import) 
spring-master 
mule-lesser .xm) // Spring 作为 主 容器 
spring-master.xml // Mule 配 置 被 加 载 (import) 


1. 以 Mule 为 主 容器 
把 Mule 作 为 主 容器 时 可 以 参考 代码 清单 18-7 所 示 的 配置 代码 ， 可 以 在 代码 清单 18-7 的 头 部 添加 以 下 配置 把 Spring 配 置 文件 的 代码 引入 (import) Mule 配 置 文件 中 (mule-masterxml) 。 


<spring:beans> 
<spring:import resource="spring-activiti-lesser.xml" /> 
</spring:beans> 


要 在 Mule 中 定义 使 用 Activiti 组 件 ， 需 要 在 XML 头 部 导入 mule-activiti 模 块 的 gcheme 定 义 ，XSD 配 置 如 下 : 


<mule xmlns:activiti=http://www.mulesoft.org/schema/mule/activiti-embedded 
xsi:schemaLocation=http://www.mulesoft.org/schema/mule/activiti-embedded http://www.mulesoft.org/schema/mule/activiti-embedded/3.2/mule-activiti-embedded.xsd> 


<activiti:connector name="actServer" 
repositoryService-ref="repositoryService" 
runtimeService-ref="runtimeService" 
taskService-ref="taskService" 
historyService-ref="historyService" /> 
<flow name="StartLeaveProcessUseMule"> 
<vm:inbound-endpoint path="startLeaveProcess" 
exchange-pattern="request-response" /> 
<activiti:create-process parametersExpression= 
"# [header: INBOUND: createProcessParameters]" /> 
</flow> 


</mul> 


在 以 上 配置 中 ，“activiti:connector” 的 作用 是 把 Spring 代理 的 Activiti Service 接 口 注 入 Mule 容 器 ， 以 便 mule-activiti 模 块 使 用 ; 在 名 称 为 “StartLeaveProcessUseMule” 的 Flow 中 配置 的 
inbound-endpoint (path 属 性 为 “startLeaveProcess”) 中 定义 了 “activiti:create-process” 组 件 ， 用 来 调用 mule-activiti 组 件 提供 的 启动 流程 功能 (示例 见 代 码 清单 18-11) 。 


在 Spring 配置 文件 (mule-master/sptring-activiti-lesser.xml) 中 需要 为 代理 的 Activiti 引 警 注入 muleContext 对 象 ， 这 样 在 Activiti 流 程 中 才 可 以 执行 Mule 任 务 ， 相 关 配 置 如 下 : 


<bean id="processEngineConfiguration" class="org.activiti.spring.SpringProcessEngineConfiguration"> 
… // 省 略 了 其 他 属性 
<property name="beans"> 
<map> 


<entry key="muleContext" 
value-ref=" muleContext"/> 
</map> 加 
</property> 


</bean> 


在 以 上 代码 中 ， 属 性 “muleContext” 是 一 个 Bean 的 引用 ， 在 初始 化 MuleContext 时 创建 ， 然 后 注入 并 共享 给 Spring 容器 。 在 Activiti 引 警 内 调用 Mule 任 务 时 必须 提供 名 称 为 “muleContext” 的 


MuleContext 对 象 。 


2. 以 Spring 为 主 容器 


把 Spring 作为 主 容器 时 需要 由 Spring 代理 MuleContext， 也 就 是 由 Spring 触发 Mule-Context 对 象 的 初始 化 方法 ， 在 Spring 配置 文件 (spring-master.xml) 中 加 入 以 下 配置 即 可 。 


<!-- MuleCcontext 工 厂 --> 
<bean id="muleFactory" class="org.mule.context 
.DefaultMuleContextFactory"></bean> 
<bean id=" muleContext" factory-bean="muleFactory" 
factory-method="createMuleContext"> 
<constructor-arg type="java.1lang.Sstring" 
value="mule/spring-master/mule-lesser.xml" /> 


</bean> 


此 时 M ule 的 配置 (mule/spring-master/mule-lesser.xml) 被 引入 Spring 配置 文件 中 ， 所 以 只 需要 定义 具体 的 服务 即 可 。 


18.5.3 ”在 流程 中 调用 Mule 


图 18-4 展 示 了 包含 Mule 任 务 的 流程 图 ， 与 讲解 Camel 时 的 流程 图 类 似 。 代 码 清单 18-10 列 出 了 图 18-4 中 与 Mule 任 务 (调用 Mule 服 务 ) 相关 的 XML 配置 代码 。 


代码 清单 18-10 图 18-4 中 与 Mule 任 务 相关 的 XML 配置 


<serviceTask idq="invokeMule" name=" 调 用 Mule 服 务 " activiti:type="mule"> // 定 义 任务 类 型 


<extensionElements> 


<activiti:field name="endpointUrl">  // 定义 调用 Mule 服 务 的 URI 
<activiti:string><! [CDATA[vm://checkDays] ]></activiti:string> 


</activiti:field> 


<activiti:fie 
<activiti:st 
</activiti:field> 
<activiti:field name="payloadExpression"> 
e 
了 


<activiti: 
</actiwvitis 


ield> 


1dq name="language"> // 设置 使 用 参数 解析 语言 ， 使 用 引擎 默认 的 JUEL 
ring><! [CDATA[juel]l]></activiti:string> 


xpression>$ {days}</activiti:expression> 


// 请 求 Mule 服 务 的 表达 式 


< 


2 


<activiti:fielgd name="resultVariable"> // 设 置 Mule 服 务 执行 完成 后 结果 保存 到 哪个 变量 


<activiti:string><! [CDATA[deptLeaderAudit]]></activiti:string> 


</activiti:field> 
</extensionElements> 


</serviceTask> 


请 假 天 数 大 于 3 


党 
调用 Mule 服 务 


1. 以 Mule 为 主 容器 


代码 清单 18-11 列 出 了 把 Mule 作 为 主 容器 时 的 测试 代码 。 


请 假 天 数 小 于 3 


EE 
部 门 经 理 审批 


加 
直接 领导 审批 


图 18-4 ”包含 Mule 任 务 的 流程 图 


代码 清单 18-11 ”测试 在 Activiti 流 程 中 调用 Moule 服务 一 一 Mule 作 为 主 容器 


@Test 
public void testMuleMaster() throws Exception { 


MuleContext muleContext = new DefaultMuleContextFactory() // 初始 化 MuleContext 


muleContext.start(); // 启动 Mule 


.CreateMuleContext ("mule/mule-master/mule-master.xml"); 


MuleRegistry registry = muleContext .getRegistry () ， 
RepositoryService repositoryService = // 从 Mule 容 器 获取 Activiti Service 接 口 


(RepositoryService) registry.get ("repositoryService"); 
repositoryService.createDeployment () ”// 部 署 流程 
.addClasspathResource ("mule/leaveWithMule.bpmn") .deploy (); 


MuleClient muleClient = new DefaultLocalMuleClient (muleContext); 
DefaultMuleMessage message = new DefaultMuleMessage("", muleContext); 
Map<String, Object> variableMap = new HashMap<String, Object> () ， 


variableMap.put ("days"，5); // 设置 days 变 量 为 5 天 


// 由 Mule 启 动 流程 需要 传递 流程 定义 KEY 参 数 


variableMap.put ("processDefinitionKey", "leaveWithMule"™); 


message.setProperty ("createProcessParameters", 


// 调用 Mule 服 务 时 的 参数 


variableMap , PropertyScope.OUTBOUND); 
MuleMessage responseMessage = // 各 Mule 发 送 启动 流程 服务 
muleClient.send ("vm://startLeaveProcess", message); 
ProcessInstance processInstance = (ProcessInstance) responseMessage.getPayload(); 
TaskService taskService = registry.get ("taskService"); 
Task task = taskService.createTaskQuery () .singleResult () ; 


assertEquals (" 部 门 经 理 审批 "，task.getName () )，; 
muleContext .stop () ， 
muleContext .qispose () ， 


2. 以 Spring 为 主 容器 


// 测试 通过 说 明 Mule 服 务 被 调用 ， 并 设置 了 deptLeaderAqduit 变 量 为 true 


代码 清单 18-12 列 出 了 把 Spring 作为 主 容器 时 的 测试 代码 。 


代码 清单 18-12 ”测试 在 Activiti 流 程 中 调用 Mule 服 务 一 一 Spring 作 为 主 容器 


@Test 
public void testSpringMaster() throws Exception { 
ApplicationContext ctx = // 初始 化 Spring 容器 
new ClassPathXxmlApplicationContext ("mule/spring-master/spring-master.xml"); 


MuleContext mc = (MuleContext) ctx.getBean(" muleContext"); 
mc.start(); // 从 Spring 获 取 MuleContext 并 开启 服务 
RepositoryService repositoryService = // 从 Spring 获取 Activiti Service 


(RepositoryService) ctx.getBean("repositoryService"); 
repositoryService.createDeployment () 


一 


.aqdqdClasspathResource ("mule/leaveWithMule.bpmn") .deploy (); 
RuntimeService runtimeService = (RuntimeService) ctx.getBean("runtimeService"); 
Map<String, Object> variableMap = new HashMap<String, Object> () ， 
variableMap.put ("days", 5); 
runtimeService.startProcessIinstanceByKey ("leaveWithMule", variableMap); 
TaskService taskService = (TaskService) ctx.getBean ("taskService"); 

Task task = taskService.createTaskQuery () .singleResult () ; 
assertEquals ("部 门 经 理 审批 "，task.getName ()); // 验证 结果 


mc.stop(); 


} 


18.6 本章 小 结 
本 章 主 要 针对 目前 流行 且 Activiti 支 持 的 两 个 ESB 平 台 一 一 Camel 和 Moule 做 了 详细 的 介绍 ， 并 针对 不 熟悉 这 两 个 平台 的 读者 提供 了 快速 入 门 示 例 ， 在 此 基础 上 一 一 讲解 了 如 何在 Activiti 流 程 中 调用 
Came| 路 由 和 Mule 服 务 。 


在 Activiti 中 集成 Camel 时 可 以 通过 URI 的 方式 配置 参数 传递 ， 在 路 由 执行 完成 后 将 结果 返回 给 引擎 的 方式 ， 本 章 都 一 一 做 了 讲解 ; 在 介绍 M ule 时 考虑 到 读者 面 对 的 开发 环境 不 同 (以 Mule 为 主 容器 或 
以 Spring 为 主 容 器 ) ， 还 介绍 了 两 种 配置 方式 的 不 同 。 


第 19 草 统一 身份 管理 


在 一 个 完整 的 系统 中 ， 身 份 模块 是 必 不 可 少 的 ， 用 于 管理 系统 的 用 户 、 组 织 、 角 色 或 者 岗位 。 在 第 5 章 中 我 们 详细 介绍 过 Activiti 的 用 户 与 组 ， 以 及 如 何 通 过 引擎 提供 的 API 维 护 两 者 之 间 的 关系 。 国 内 大 
多 数 系统 都 会 有 组 织 的 管理 ， 而 在 Activiti 中 并 没有 组 织 的 概念 ， 也 没有 角色 (Role) 的 管理 ， 取 而 代 之 的 是 组 (Group) 。 


现在 遇 到 的 问题 就 是 业务 系统 有 一 套用 户 管理 系统 ， 而 Activiti 也 提供 了 一 套用 户 管理 的 机 制 (虽然 相对 来 说 比较 简单 ) ， 同 时 维护 两 套用 户 数据 从 成 本 和 易 用 性 上 考虑 都 不 太 可 取 ， 本 章 将 介绍 几 种 用 
户 数据 同步 的 方案 。 


19.1 ”一 套 典 型 的 身份 系统 

图 19-1 展 示 的 是 一 个 典型 的 身份 系统 ER 图 ， 相 比 Activiti 的 身份 模块 (以 ACT_ID 开 头 的 表 ) 多 出 了 几 张 表 ， 例 如 组 织 结构 表 (ID ORG) 、 资 源 表 (ID_RESOURCES) 。 图 19-1 的 设计 代表 了 大 多 数 的 
设计 思想 ， 也 基本 能 满足 国内 客户 对 身份 管理 的 需求 ， 本 章 内 容 将 以 此 作为 背景 资料 进行 讲解 。 

针对 图 19-1 的 ER 图 定义 了 相应 的 实体 ， 如 图 19-2 所 示 ， 包 含 了 以 下 几 个 实体 对 象 (为 了 简便 起 见 只 定义 了 必要 的 几 个 属性 ) : 

. AiaUset: 用 户 实体 。 

. AiaDepartment: 部 门 实体 。 

. AiaResoutce: 资源 实体 。 


. AiaRole: 角色 实体 。 


组 织 结构 (ID_ORG) 
ID NUMBER'20 <pk> 
上 级 组 如 ID NUMBER(20) 
组 织 敬 varchar2(255) 


NUMEBER 2d p> 
varchar2 (100] 


何 标 varchar2(255) 
部 门 主管 varchar2(20) 
排序 号 varchar2(20) 
所 在 地 varchar2(30) 
丢 注 varchar2(1000) 


varchar2(100] FR_ UCERROLE_ REP_ ROLE 
NUMBER (20) 
varchar2t100) 

未 局 于 系 婉 warchar2(100) 


站 昌 本 5 是 A TES 
FE ORG RELATION REF OR 


朋 色 资源 关系 (ID_ROLE_RESOURCES)| 用户 和 和 角色 关系 (ID_USER_ROLE)| | 组织 和 用 户 关系 (ID_USER_ORG) 


角色 ID NUMBER(20) <fk1> 用 户 ID NUMBER(20) <fk2> 组 织 ID _ NUMBER(20) <fk2> 
资源 ID NUMBER(20) <fk2= 才 色 ID NUMBER(20) <fk1> 用 户 ID _ NUMBER(20) <fk1> 
PK ROLE FES REF FE FE ORG RELATION REF USER 
资源 (ID_RESOURCES) 用 户 (ID_USER) 
ID NUNMEER (2D) le NUMEER 20) 
歇 福 汕 varchare (oso 2 varchar2 (50) 
上 级 ID 加 UW 好 FR {20 s varchar2(50) 
次 源 ImD 2 FR_USER_ REF_ROLE 密码 VARCHAR2 (99 CHAR) 


资源 说 明 “Undefineq> VARCHAR2 .30 CHAR) 
: CHAR [1Y 

R 箱 YARCHAR2 (99 CHAR) 

直接 领导 ID MUMEER [20) 


图 19-1 一 个 典型 的 身份 系统 ER 图 
@ AiaUser 
人 Did DD id Long 
人 心 dept AiaDepartment ‘Dy name String 
DD userName String 


loginName String 
人 password String 


一 一 


AiaResource BB AiaRole 

优 id Long 仿 id Long 
全 descrlption String DroleName String 
' parentld Long DD resources ource> 


DD resourceName String 


图 19-2 ”与 图 19-1ER 图 对 应 的 实体 图 


19-3 展 示 的 是 操控 实体 对 象 的 接口 ， 提 供 基本 的 CRUD 功 能 ， 各 个 接口 的 说 明 如 下 : 


AiaUserManager: 用 户 实体 管理 接口 。 
“ AiaDepartmentManaget: 部 门 实体 管理 接口 。 
. AiaRoleManaget: 角色 实体 管理 接口 ， 可 以 通过 findByUserId0 方 法 查询 到 用 户 拥 有 的 角色 列表 。 


AiaResourceManager: 资源 实体 管理 接口 。 


各 AiaUserManager ' AiaDepartmentManager 
wD get(Long) AlaUser ww get(Long) AiaDepartment 
ww findByLoginName(String) aUser WwW save(AiaDepartment) iaDepartment 
WD savelAiaUser) AiaUser wD delete(Long) void 
,delete(Long) void 


@ AiaRoleManager 


wD yel(Long) AiaRole | 


由 get(Long) AlaResource WW findByUserld(Long)t<AiaRole> 
ww savelAiaResource) AiaResource 过 save(AiaRole) AiaRole 


Ww delete(Long) void wD delete(Long) void 


@ AiaResourceManager 


图 19-3 ”操控 图 19-2 中 实体 的 接口 定义 


在 5.1 节 中 学 习 了 如 何 使 用 IdentityService 接 口 管理 用 户 与 组 ， 以 及 用 户 与 组 的 关系 假设 现 有 系统 已 经 提供 了 一 套 基于 图 19-1 的 数据 结构 的 身份 管理 模块 或 独立 系统 ， 需 要 把 这 些 数据 同步 到 Activiti 的 
身份 数据 表 中 或 者 通过 配置 为 Activiti 提 供 身份 模块 的 数据 ， 我 们 该 如 何 实现 呢 ? 


笔者 根据 实施 经 验 针对 不 同 的 情况 提供 了 几 种 解决 方案 ， 读 者 可 以 据 此 选择 合适 的 数据 同步 方式 。 


A em a wa ee me | 
] 用 1 局 | 区 慷 | [ 唱 |z 声 冬 X] 上 让 
人 |l 手 JX IJ RAJ 


通过 引擎 接口 同步 数据 是 一 种 “ 非 侵入 式 ” 的 同步 方式 ， 做 法 类 似 于 引擎 中 的 监听 ， 当 现 有 身份 模块 的 用 户 数据 变更 时 调用 Activiti 引 上 警 的 IdentityService 接 口 的 对 应 方法 同步 操作 ， 相 关 代 码 可 以 参考 
5.1 节 的 内 容 。 


当然 在 同步 数据 时 要 做 好 数据 的 核验 工作 ， 例 如 在 添加 、 修 改 用 户 和 组 时 要 先 检 查 对 象 是 否 人 存在 防止 引擎 接口 抛 出 异常。 


下 面 针 对 图 19-3 中 的 接口 定义 实现 具体 的 身份 数据 同步 逻辑 ， 代 码 清单 19-1 实 现 了 AiaUserManager 接 口 。 以 新 增 或 更 新 用 户 数据 为 例 ， 当 管理 员 在 身份 管理 系统 中 新 增 或 更 改 一 个 用 户 时 ， 通 过 
Activiti 的 IdentityService 接 口 把 当前 操作 的 用 户 对 象 同步 到 引擎 的 身份 模块 表 中 。 其 他 几 个 接口 就 不 再 一 一 列举 了 ， 可 以 参考 5.1 节 的 内 容 实 现 AiaRoleManager 接 口 同步 角色 及 其 与 用 户 的 关系 。 


代码 清单 19-1 AiaUserManager 接 口 实现 类 


public class AiaUserManagerIimpl implements AiaUserManager 1{ 
private AiaUserDao dao; 
private IdentityService identityService; 
public AiaUser get (Long id) { return dao.get(id); } 
public AiaUser findByLoginName (String loginName) { 
return dao.findByLoginName (loginName); 


} 
public AiaUser save (AiaUser user) { // 新 增 或 更 新 用 户 对 象 时 同步 数据 到 Activiti 
dao.save (user); // 持久 化 用 户 
User activitiUser = null; 
if (user.getIdq() 一 nu11) { // 新 增 用 户 到 Activiti 身 份 模块 
activitiUser = identityService.newUser (user.getl1Id() .toString ()); 
} else { // 从 引擎 表 查 询 已 有 用 户 
activitiUser = | createUserQuery () 
d(user.getId() .tostring()).singleResult (); 
/xx 省 略 代 码 复制 usez 的 局 性 到 activitiUser 
identityService.saveUser (activitiUser); // 保存 用 户 


return user; 


} 
public void qelete (Long id) { dao.delete(id); } 


这 种 同步 身份 数据 方式 的 特点 在 于 “不 破坏 ”引擎 表 结构 、 面 向 接口 编程 。 如 果 根 据 用 户 1D 查 询 相 关 的 候选 任务 ， 那 么 SQL 的 过 渡 条 件 为 : 在 ACT_RU_IDENTITYLINK 表 中 类 型 为 “candidate” 上 且 
USER_ID 字段 等 于 当前 用 户 ID， 或 者 任务 有 候选 组 目 当 前 人 与 候选 组 有 关联 关系 (在 ACT_ID_MEMBERSHIP 表 中 维护 ) 。 当 我 们 操作 业务 系统 的 用 户 、 角 色 以 及 两 者 的 关系 时 把 这 些 更 改 都 同步 到 引擎 
表 中 ， 所 以 引擎 内 部 的 SQL 关联 查询 可 以 正常 工作 。 之 所 以 在 这 里 强调 用 户 与 组 的 天 系 是 因为 下 面 介绍 的 第 2 种 方式 就 不 能 使 用 与 ACT_ID_MEMBERSHIP 表 关联 查询 了 ， 因 为 下 面 的 方式 会 茶 用 引 警 的 身份 
模块 表 (引擎 不 创建 以 ACT_ID 开 头 的 表 ) 。 


2. 自 定义 Session 工 厂 


Activiti 的 每 一 张 表 都 有 一 个 对 应 的 实体 管理 器 ， 在 引擎 初始 化 时 会 初始 化 所 有 表 的 实体 管理 类 (提供 CRUD 等 功能 ) ， 每 一 个 实体 类 都 有 一 个 对 应 的 实体 管理 类 (XxxEntityManager) 及 实体 管理 工厂 
类 (XxxEntityManagerFactory) 。 实 体 管理 工厂 类 实现 SessionFactory 接 口 ， 以 用 户 表 的 实体 管理 为 例 ， 用 户 实体 类 的 实体 管理 工厂 类 如 图 19-4 所 示 。 图 19-5 则 展示 了 用 户 实体 管理 类 的 继承 图 。 


结合 图 19-4 与 图 19-5 可 以 了 解 到 UserEntityManager 类 实现 了 Session 与 Userldentity-Manager 接 口 (定义 了 针对 用 户 实 体 的 CRUD 方 法 ) ， 而 UserEntityManagerFactory 实 现 了 SessionFactory 接 
口 并 实现 其 两 个 方法 ， 具 体 的 实现 代码 见 代码 清单 19-2 所 示 。 


入 Se55ionFactory 
a) getSessionTypeO) Class<?> 


ww) openSession() Sesslaon 


下 本 


i ES EGG ES EEC ES FE 二 三 和 


B UserEntityManagerFactory 


w getSessionTypel) Class<+> 


图 19-4 ”用户 实 体 管 理工 厂 类 User-EntityManagetFactory 


@ Session 


@ AbstractManager UserldentityManager 


和 全 UserEntityManager 


图 19-5 用户 实体 管理 类 UserEntity-Managet 继 承 图 


代码 清单 19-2 UserEntityManagerFactory 类 


public class UserEntityManagerFactory implements SessionFactory ({ 
public Class< ? > getSessionType() 1 

// 把 UserIdentityManager 接 口 注册 到 引 苟 

// 由 openSession() 方 法 返回 具体 的 实现 类 

return UserIdentityManager.class; 


} 
// 创建 一 个 新 的 实体 管理 类 对 象 


public Session openSession() { return new UserEntityManager(); |} 


实体 管理 的 机 制 是 为 本 节 内 容 做 的 铺垫 ， 引 警 允许 我 们 履 盖 内 置 的 实体 管理 器 使 用 自 定义 的 实体 管理 器 蔡 代 默认 实现 类 ， 以 此 我 们 可 以 替换 与 引 警 和 身份 模块 有 关 的 实体 管理 类 ， 把 我 们 自 定 义 的 实体 
管理 类 注入 引擎， 自 定义 的 实体 管理 类 只 要 实现 引擎 的 接口 即 可 。 下 面 的 代码 设置 了 引擎 配置 对 象 的 customSessionFactories 属 性 ， 并 为 该 属性 添加 了 两 个 实现 了 SessionFactory 接 口 的 bean 对 象 。 完 整 的 
配置 参考 配套 资源 中 本 章 示 例 代码 的 src/resources/chapter19/applicationContext-session.xml。 


<bean id="processEngineConfiguration" class="org.activiti.xx.XxxProcessEngineConfiguration"> 
<!-- 组 织 机 构 适 配 --> 
<property name="customSessionFactories"> 
<list> <!-- 用 户 (User) 实体 管理 器 工厂 --> 
<bean class="me.kKkafeitu.activiti.chapter19 
.ijdentity.session.AiaUserEntityManagerFactory"> 
<property name="aiaUserEntityManager"> 
<bean class="me.kafeitu.activiti. 

chapterl19.identity.session.AiaUserEntityManager"> 

<property name="aiaUserManager" 
ref="aiaUserManager"/> 


</bean> 
</property> 
</bean> 
<!-- 组 (Group) 实体 管理 器 工厂 --> 


<bean class="me.kafeitu.activiti.chapter19 
.ijdentity.session.AiaGroupEntityManagerFactory"> 
<property name="aiaGroupEntityManager"> 
<bean class="me.kafeitu.activiti. 
chapterl19.identity.session.AiaGroupEntityManager"> 
<property name="aiaRoleManager" 
ref="aiaRoleManager"/> 
</bean> 
</property> 
</bean> 
</list> 
</property> 
</bean> 
<! 一 用 户 实体 管理 器 --> 
<bean id="aiaUserManager" class="me.kafeitu.activiti. 
chapterl9.identity.impl.AiaUserManagerIimpl"> 
<property name="dao"> 
<bean class="me.kafeitu.activiti. 
chapter19.identity.impl.AiaUserDaoImpl" /> 
</property> 
<property name="identityService" ref="identityService"/> 
</bean> 
<!- 角 色 实 体 管 理 器 --> 
<bean id="aiaRoleManager" class="me.kafeitu.activiti. 
chapterl19.identity.impl.AiaRoleManagerIimpl"> 
<property name="dao"> 
<bean class="me.kafeitu.activiti. 
chapter19.identity.impl.AiaRoleDaoImpl"/> 
</property> 
</bean> 


上 面 的 代码 分 别 定 义 了 两 个 实体 管理 工厂 Bean 并 将 它们 加 入 到 引 掌 的 自 定义 Session 工 厂 集合 中 ， 每 一 个 工厂 Bean 均 实现 SessionFactory 接 口 来 声明 该 工厂 的 Session 类 型 。 代 码 清单 19-3 和 代码 清 
19-4 分 别 定义 了 用 户 (User) 和 组 (Group) 的 实体 管理 Session 工 厂 类 。 


代码 清单 19-3 AiaUserEntityManagerFactory 类 


public class AiaUserEntityManagerFactory implements SessionFactory { 
private AiaUserEntityManager aiaUserEntityManager; 
public void setAiaUserEntityManager (AiaUserEntityManager aiaUserEntity Manager) { 
this.aiaUserEntityManager = aiaUserEntityManager; 
' 


public Class<?> getSessionType() { return UserIidentityManager.class; } #1 
public Session openSession() { return aiaUserEntityManager; } #2 


代码 清单 19-4 AiaGroupEntityManagerFactory 类 


public class AiaGroupEntityManagerFactory implements SessionFactory ({ 
private AiaGroupEntityManager aiaGroupEntityManager; 
public void setAiaGroupEntityManager (AiaGroupEntityManager aiaGroupEntityManager) { 


this.aiaGroupEntityManager = aiaGroupEntityManager; 


public Class<?> getSessionType() { return GroupIdentityManager.class; } #1 
public Session openSession() { return aiaGroupEntityManager; } #2 


在 代码 清单 19-3 和 代码 清单 19-4 中 ，#1 处 分 别 返 回 了 不 同 的 Session 类 型 ， 引 擎 在 获取 Session 时 会 通过 Session 的 类 型 从 Session 池 (一 个 Map 对 象 ) 中 获取 ; #2 处 则 分 别 返 回 具体 的 Session 实 现 类 对 
象 。Session 实 现 类 的 定义 见 代码 清单 19-5 和 代码 清单 19-6 所 示 。 


代码 清单 19-5” 自 定义 的 用 户 实体 管理 器 AiaUserEntityManager 


public class AiaUserEntityManager extends UserEntityManager { 
private AiaUserManager aiaUserManager; 
public Boolean checkPassword(String userId, String password) { 
AiaUser aiaUser = aiaUserManager.get (new Long (userId) ) 
return aiaUser.getPassword() .equals (password); 


} 
public void setAiaUserManager (AiaUserManager aiaUserManager) { 
this.aiaUserManager = aiaUserManager; 


} 


代码 清单 19-5 中 履 盖 了 引擎 内 部 的 UserEntityManager 的 checkPassword() 方 法 ， 该 方法 用 来 校 验 用 户 名 和 密码 是 否 匹配 : 在 覆盖 的 方法 中 调用 企业 内 部 的 身份 模块 接口 查询 到 用 户 对 象 并 校 验 用 户 输 
入 的 密码 是 否 匹 配 ，checkPassword() 方 法 在 用 户 登 录 时 会 被 调用 。 


代码 清单 19-6 ” 自 定 义 的 组 实体 管理 器 AiaGroupEntityManager 


public class AiaGroupEntityManager extends GroupEntityManager ({ 
private AiaRoleManager aiaRoleManager; 
public void setAiaRoleManager (AiaRoleManager aiaRoleManager) { 
this.aiaRoleManager = aiaRoleManager; 
} 


Pubj ic List<Group> findGroupsByUser (String UserId) { 
List<AiaRole> roles = aiaRoleManager.findByUserlid (new Long (userId) ) 
List<Group> groups = new ArrayList<Group> (roles.size()); 
for (AiaRole aiaRole : roles) { // 循环 转换 AiaRole 为 GroupEntity 对 象 
GroupEntity group = new GroupEntLILY () 
group.setName (aiaRole.getRoleName () ); // 角色 中 文 名 称 
group.setId(aiaRole.getRoleCode () ); // 角色 英文 名 称 
groups .aqd (group); 


} 


return groups; 


在 代码 清单 19-6 中 履 盖 了 引擎 的 组 实体 管理 器 GroupEntityManager 的 findGroupBy-User() 方 法 ， 该 方法 可 以 根据 用 户 ID 查 询 拥有 的 角色 集合 。 当 然 除 了 这 个 方法 还 可 以 根据 需要 履 盖 其 他 的 方法 ， 这 
里 就 不 一 一 列举 了 。 


19.3 ”用 视图 代 蔡 物理 表 


在 引擎 中 ， 与 身份 相关 的 表 如 下 : 

. ACT_ ID_USER: 用 户 表 。 

" ACT_ID_INFO: 用 户 信息 表 。 

. ACT_ID_GROUP: 组 ， 也 可 以 理解 为 角色 。 

. ACT_ID_ MEMBERSHIP: 用 户 与 组 的 关系 ， 这 也 是 查询 任务 候选 人 需要 关联 的 表 。 

相 比 前 两 种 方式 ， 使 用 视图 代理 物理 表 显 得 “ 轻 量 ”一 些 ， 把 引擎 的 物理 表 删 除 ， 取 而 代 之 的 是 与 物理 表 同 名 的 视图 ， 只 要 保证 视图 的 表 结 构 与 原来 的 物理 表 的 表 结 构 及 字段 类 型 保持 一 致 即 可 。 


在 删除 了 引擎 身份 模块 的 物理 表 后 启动 会 报错 ， 提 示 缺 少 身份 模块 的 表 ， 异 常 信息 如 下 : 


org.activiti.engine.ActivitiException: Activiti database problem: Tables missing for component (s) identity 


从 表面 看 ， 是 因为 缺少 身份 模块 的 表 。 但 是 有 同名 的 视图 存在 为 什么 引擎 依然 提示 缺少 表 呢 ?这 是 因为 引擎 会 检查 “ 表 ” 的 类 型 ,虽然 名 称 相 同 ， 但 是 类 型 不 是 物理 表 (table) 而 是 视图 (view) 。 
过 Activiti 开 发 团队 可 能 早 就 料 到 我 们 会 抛弃 这 个 简陋 的 身份 模块 ， 所 以 为 我 们 开启 了 一 道 大 门 ， 人 允许 我 们 放弃 身份 模块 也 就 是 说 在 初始 化 引擎 时 不 再 检查 ACT_ID_* 表 是 否 存 在 ， 相 当 于 禁用 了 身份 模块 的 功 
能 。 下 面 的 代码 把 属性 “dbldentityUsed” 设 置 为 “false”， 即 禁用 了 身份 模块 的 功能 。 


<bean id="processEngineConfiguration™" class="org.activiti.spring.SpringProcessEngineConfiguration"> 


<property name="dbIdentityUsed" value="false"/> 
</bean> 


19.4 集成 LDAP 


LDAP (Lightweight Directory Access Protocol， 轻 量 目录 访问 协议 ) 被 用 来 管理 地 址 注 或 人 员 与 资源 的 关系 。 一 般 当 企业 中 有 多 个 业务 系统 时 会 使 用 LDAP 统 一 管理 用 户 资源 ， 各 个 系统 不 需要 单独 
维护 而 是 通过 LDAP 协 议 获取 所 需 用 户 数据 。 


Activiti 从 5.13 版 本 开始 提供 了 activiti-ldap 模 块 ， 用 来 整合 Activiti 与 LDAP 服 务 ， 也 就 是 放弃 Activiti 的 身份 模块 ， 当 引擎 需要 读 取 用 户 、 组 数据 时 调用 LDAP 接 口 访问 。 但 是 activiti-ldap 模 块 只 提供 用 
户 数据 查询 功能 ， 不 文 持 有 关 数 据 更 改 的 操作 (新 增 、 删 除 、 更 新 等 ) ， 例 如 验证 用 户 名 和 密码 是 否 匹配 以 及 查询 用 户 有 哪些 候选 (Candidate) 任务 。 


在 Activiti 中 集成 LDAP 服 务 也 比较 简单 ， 添 加 依赖 的 Jar 包 后 在 引擎 配置 对 象 中 注入 activiti-ldap 模 块 的 配置 类 org.activiti.ldap.LDAPConfigurator。 本 章 的 Spring 配置 文件 中 加 入 了 针对 LDAP 服 务 的 配 
置 代码 ， 相 关 配 置 见 代码 清单 19-7 所 示 。 


代码 清单 19-7 Activiti 引 警 配置 对 象 中 的 LDAP 配 置 


<1!-- 舱 入 LDAP 服 务 器 (从 clLlasspath 环 境 中 读 取 ) -=-> 
<security:1ldap-server 1dqif="classpath:chapter19/users.1dqif" root="o0=aia"/> #1 
<bean igd="processEngineConfiguration" // 可 以 配 所 有 实现 了 引擎 配置 接口 的 类 
class=" org.activiti.spring.SpringProcessEngineConfiguration"> 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15030/0EBPS/Text/... 
<property name="configurators"> // 把 LDAP 配 置 对 象 注入 给 引擎 
<list> 
<bean class="org.activiti.ldap.LDAPConfigurator"> // LDAP 配 置 对 象 
<! 一 LDAP 服 务 器 配置 参数 --> 
<property name="server" value="ldap://localhost" /> // LDAP 服 务 地 址 
<property name="port" value="33389" /> // LDAP 服 务 端 
<property name="user" // 访问 LDAP 的 账号 
value="uid=agdmin, ou=users, o=aia"™" /> 
<property name="password" value="pass" /> // 访问 LDAP 的 密码 
0 name="initialContextFactory"” // ContextFactory 工 三 类 (默认 值 ) 
Jue="com.sun . jngi.] dap.LdapCtxFactory" /> 
// 连 接 LDAP 时 设置 的 " java.naming.security.authentication" 属 性 值 ( 默 认 值 ) 
<property name="securityAuthentication" value="simple" /> 
<property name="customConnectionParameters"> 
<map> // 可 以 设置 自 定义 连接 参数 ， 例 如 连接 池 、 安 全 属性 等 
<entry key="key" value="value"></entry> 
</map> // 参见 http://docs.oracle.com/javase/tutorial/jndi/ldap/jndi.ntml 
</property> 
<! 一 查询 数据 的 过 滤 条 件 --> 
// Distinguished?Name, 查询 数据 的 基础 名 称 ， 相当 于 数据 库 中 的 主键 
<property name="baseDn" value="o=aia Ls 
// 查询 用 户 的 DN， 如 果 不 设置 该 属性 ， 职 欠 从 用 baseDn 属 性 的 人 
<property name="userBaseDn" value="ou=Uusers,o=aia" /> 
// 查询 组 的 DN， 如 果 不 设置 该 属性 ， 默 认 使 用 baseDn 属 性 的 值 
<property name="groupBaseDn" value="ou=groups,o=aia" /> 
<property name="queryUserByUserTd" // 根据 用 户 ID 查 询 语句 
value=" (& (objectClass=inetOrgPerson) (uigd={0}))" /> 
<property name="queryUserByFullNameLike" // 全 名 查询 语句 
value=" (& (objectC ass=inetOrgPerson) (| ({0}=*{1}*) ({2}=*{3}*)))" /> 
<property name="queryGroupsForUser" // 查询 用 户 所 属 组 语句 
value=" (& (objectC] ass=groupOf UniqueNames) (uniqueMember={0}))" /> 
<! 瑟 LDAP 数 据 源 中 资源 相关 属性 定义 --> 
<property name="userIdAttribute" value="uid" /> // 匹配 用 户 ID 
<property name="userFirstNameAttribute" value=" cn" /> // 匹配 用 户 的 姓 
<property name="userLastNameAttribute" value="sn" /> // 匹配 用 户 的 名 
<property name="groupIdAttribute" value="gid" /> // 匹配 组 ID 的 属性 名 
<property name="groupNameAttribute" value="cn" /> // 匹配 组 名 称 的 属性 名 
</bean> 
</list> 
</property> 
</bean> 


- 吕 


代码 清单 19-7 列 出 了 有 关 LDAP 的 配置 ， 完 整 的 配置 可 以 参考 本 章 示 例 目 录 的 src/mainy/resoutces/applicationContext,xml 文 件 。 本 章 示例 代码 由 # 处 嵌入 的 LDAP 服 务 器 提供 数据 ， 用 户 和 组 数据 定义 在 本 
音源 码 的 stc/main/resources/ chapter19/ users.ldif 文 件 中 。 


除了 代码 清单 19-7 中 列 出 来 的 一 些 基 本 配置 属性 之 外 ，activiti-ldap 模 块 还 支持 高 级 配置 ， 这 样 可 以 由 用 户 自 定义 内 部 的 实现 覆盖 默认 实现 类 ， 例 如 如 何 查询 用 户 、 组 。activiti-ldap 支 持 覆 盖 的 属性 如 
表 19-1 所 示 。 


表 19-1 activiti-ldap 模 块 的 高 级 属性 


属性 名 称 作 用 默 认 值 


ldapUserManager- 代 符 查询 用 户 工 厂 类 LDAPUserManager- org.activiti.ldap. LDAPUserManager- 
Factory Factory Factory 


ldapGroupManager- 代替 查询 组 工厂 类 LDAPGroupManager- org.activiti.ldap. LDAPGroupManager- 
Factory Factory Factory 


IldapMemberShip- 代替 查询 用 户 与 组 的 工厂 类 LDAP- org.activiti.ldap. LDAPMembership- 
Managerkactory MembershipManagerFactory ManagerFactory 


自 定 义 查 询 构 造 器 ， 可 以 替换 查询 LDAP 
数据 的 方法 


组 缓存 的 大 小 ， 如 果 值 小 于 0， 就 不 会 他 
建 缓存 


设置 组 绥 存 的 过 期 时 间 ， 单 位 为 军 秘 
当 获 取 特 定 用 户 的 组 时 ， 如 果 组 缓存 也 启用 

了 , 组 会 保存 到 绥 存 中 ， 并 使 用 这 个 属性 设 

groupCacheExpira- 的 时 间 例如 ， 如 果 组 在 00:00 被 获取 ， 
tionTime 过 期 时 间 为 30 分 钟 , 那么 所 有 在 Wa 之 
后 进行 的 查询 都 不 会 使 用 缓存 ， 而 是 再 次 去 
LDAP 查询 。 因 此 ， 所 以 作 00:00-00:30 进 

行 的 查询 都 会 使 用 绥 存 


ldapQueryBuilder org.activiti.ldap. LDAPQueryBuilder 


-1 ， 不 绥 存 


groupCacheSize 


1 小 时 


19.5 本章 小 结 


本 章 讲解 了 几 种 已 有 用 户 数据 与 Activiti 身 份 模 块 同步 的 方式 , 分 为 “侵入 ” 式 与 “ 非 侵入 ” 式 ， 具体 介绍 了 通过 引擎 接口 同步 数据 、 自 定义 Session 工 三 ， 以 及 视图 代替 物理 表 的 方式 。 本 章 还 介绍 了 
如 何 从 LDAP 查 询 用 户 、 组 数据 。 读 者 可 以 根据 不 同 的 需求 以 及 环境 选择 合适 的 同步 方式 ，。 


第 20 草 ” REST 服务 


在 企业 应 用 中 ， 常 见 的 系统 或 平台 都 会 提供 多 种 接口 方式 ， 例 如 标准 的 Java API、TCP 协 议 、 基 于 SOAP (Simple Object Access Protocol， 简 单 对 象 访问 协议 ) 的 Web service， 以 及 
REST (Representational State Transfer， 表 述 性 状态 转移 ) 软件 风格 等 ， 一 般 这 种 软件 风格 被 称 为 Restful。 


作为 一 个 BPM 平 台 Activiti 提 供 了 基于 Restful 风 格 的 AP1， 从 而 可 以 通过 HTTP 协 议 访问 Activiti 的 REST API 实 现 流程 的 各 种 操作 ， 同 时 也 做 到 了 跨 平台 、 跨 语言 的 通信 。 假 如 已 有 基于 .NET 或 PHP 平 台 开 
发 的 应 用 需要 使 用 工作 流 ， 可 以 通过 HTTP 协 议 访问 Activiti 的 REST APl 来 操控 流程 引擎 ， 使 用 方 无 须 关 心 流程 引擎 使 用 哪 种 语言 实现 ， 这 样 就 形成 了 一 个 流程 中 心 ， 所 有 应 用 的 流程 都 存储 在 一 个 数据 库 
中 ， 方 便 统 一 管理 。 


20.1 ”通信 协议 简介 


Web Service 是 常用 的 跨 平台 数据 交互 技术 之 一 ， 它 的 三 个 要 素 有 : SOAP、WSDL (WebService Description Language) 、UDID (Unique Device ldentifier) 。Web Service 使 用 XML 语言 定义 
WSDL， 用 来 描述 Web service 中 包含 的 方法 及 其 参数 和 返回 值 信息 。XML 是 一 种 通用 语言 ， 各 个 不 同 的 广 商 、 语 言 只 要 遵循 同一 套 标准 ， 通 过 XML-RPC 方 式 (Remote Procedure Call Protocol， 远 程 过 
程 调用 协议 ) 即 可 实现 跨 平台 通信 。 


1999 年 6 月 W3C 和 IETF 组 织 公 布 了 RFC 2616， 也 就 是 现今 使 用 最 广泛 的 HTTP 1.1 协 议 。 在 这 个 版 本 中 定义 了 九 种 方法 (也 可 以 称 之 为 “动作 ”) 来 区 分 URI 指 定 的 资源 处 理 方式 ， 包 括 OPTIONS、 
HEAD、GET、POST、PUT、DELETE、TRACE、CONNECT、PATCH。 关 于 每 一 种 方法 的 解释 可 以 参考 维基 百科 : http://zh.wikipedia.org/zh/ 超 文本 传输 协议 。 


REST 最 早 是 由 Roy Thomas Fielding 博 士 在 2000 年 的 学 术 论文 《Architectural Styles and the Design of Network-based Software Architectures》 中 提出 的 ， 它 是 一 种 针对 网 络 应 用 设计 的 架构 模 
式 ， 从 表面 上 看 能 让 客户 端 请 求 的 URI 更 加 友好 化 ， 从 系统 开发 层面 来 讲 可 以 降低 系统 的 复杂 性 ， 从 而 提升 系统 的 可 伸缩 性 。 


一 个 典型 的 REST 架 构 的 URI 大 致 如 下 (描述 的 是 有 关 IT 类 的 数目 ) 。 

http://www.site.com/book/it 

当 使 用 GET 方 法 访问 时 会 列 出 所 有 的 书目 ; 当 使 用 POST 方法 访问 时 会 新 增 一 本 图 书 ; 当 使 用 DELETE 方 法 访问 时 会 删除 所 有 IT 类 的 数目 。 
下 面 的 这 个 URI 与 上 面 的 类 似 ， 但 是 作用 不 同 。 

http://www.site.com/book/it/321 


这 个 URI 中 的 321 表 示 书 的 ID， 当 使 用 GET 方 法 访问 时 可 以 得 到 与 1D 对 应 的 书 的 介绍 信息 ， 例 如 书 名 、 作 者 、ISBN、 价 格 等 ， 可 以 选择 任意 的 网 络 媒体 格式 (例如 XML、JSON) 。 当 使 用 DELETE 方 法 
时 会 删除 ID 为 321 的 图 书 。 


有 关 REST 协 议 的 详细 介绍 可 以 参考 维基 百科 : http://zh.wikipedia.org/zh/REST。 


20.2 REST API 概 述 


目前 大 家 对 基于 Java 语 言 的 REST 框 架 已 经 比较 成 熟 ， 例 如 Apache CXF、Restlet 等 。Activiti 5.16.3 版 本 之 前 使 用 了 Restlet 作 为 REST 基 础 框架 ， 读 者 可 以 在 官方 源码 的 基础 上 方便 地 通过 二 次 开发 进行 
功能 扩展 。 从 5.16.4 版 本 开始 由 Restlet 切 换 到 了 Spring MVC 作 为 REST 基 础 框架 ， 但 是 在 5.16.4 版 本 中 并 没有 修改 REST API 的 资源 URL， 仪 仪 把 实现 框架 做 得 更 好 而 已 。 表 20-1 列 出 了 REST API 提 供 的 几 大 
类 资源 ， 每 一 个 大 类 都 用 一 个 单词 作为 资源 的 基础 URI。 


表 20-1 Activit REST API 资 源 


资源 分 类 资源 基础 URI 说 朋 
5| 擎 管理 (Deployments) management 用 来 获取 引擎 信息 、 管 理 作 业 (Job)、 查 询 引擎 的 数据 库 表 等 


流程 仓库 (Repository ) repository 用 来 部 团 、 查 询 、 删 除 流 程 定 义 , 创建 、 读 取 模 型 (Model) 等 


运行 时 (Runtime ) runtime 用 来 管理 运行 时 流程 实例 、 任 务 、 变 量 、 事 件 、 批 注 等 


资源 分 类 资源 基础 URI 说 明 


历史 (History) 用 来 管理 历史 流程 实例 、 人 尾 务 、 变 量 、 批 注 等 

表单 (Form ) 用 来 读 取 表单 内 容 、 提 交 任 务 表单 数据 

身份 (Identity) 用 来 管理 用 户 、 组 数据 以 及 用 户 名 和 密码 校 验 等 功能 
查询 ( Query) 查询 运行 时 及 历史 流程 实例 、 任 务 等 


Restful 风 格 的 URI 很 直观 易 懂 ， 按 照 资 源 的 层级 依次 拼接 ， 以 不 同 的 HTTP 方 法 请 求 触发 被 请 求 资源 的 不 同 动作 。 关 于 完整 的 REST API 定 义 可 以 查看 用 户 手册 中 的 REST 部 分 ， 其 中 详细 介绍 了 每 一 个 资 
源 的 作用 、 接 收 的 参数 以 及 返回 结果 等 。 


下 面 展 示 了 根据 任务 ID 获取 任务 对 象 的 URI。 


http://localhost:8080/activiti-rest/runtime/tasks/{taskId} 


这 个 URI 中 的 activiti-rest 是 REST API 的 应 用 名 称 ，runtime 是 运行 时 类 资源 的 基础 URI，tasks 是 任务 类 型 的 资源 ，{task1d} 表 示 需 要 在 使 用 时 替换 成 实际 的 任务 ID (与 本 书 中 的 Spring MVC 控 制 器 的 
@ RequestMapping 注 解 语法 类 似 ) 。 下 面 的 URI 用 数字 125 代 蔡 {taskld}， 表 示 读 取 任 务 1D 为 125 的 任务 对 象 。 


http://Localhost:8080/activiti-rest/zuntime/tasks/125 


请 求 该 URI 后 “应 该 ” ( 稍 后 解释 ) 会 得 到 类 似 以 下 的 JJON 数 据 : 


vid": v4396™, 
"url": "http://localhost:8080/aia/rest/runtime/tasks/4396", 
"owner": null, 
"assignee": "kafeitu", 
"delegationState": null, 
"mame"™: "调整 申请 "， 
"description": null, 
"createTime": "2014-01-23T08:31:09.894+0000"™, 
"dueDate": null, 
oriority"s 30, 
"suspended": false, 
"taskDefinitionKey": "modifyApply", 
1 tenan tId™: mw We 
"category": null, 
"parentTaskId": null, 
"parentTaskUrl": null, 
"executionId" : "4370"™, 
"executionUrl": "http://localhost:8080/aia/rest/runtime/executions/4370", 
"processInstanceld™": "4370", 
"processInstanceUril": 
"nttp://localhost:8080/aia/rest/runtime/process-instances/4370", 
"processDefinitionId": "leave:1:3020", 
"processDefinitionUrl": "http://localhost:8080/aia/rest/repository/process-definitions/leave%3A1%3A3020", 
"variables": [] 


事实 并 不 是 我 们 所 期 望 的 那样 ， 直 接 访问 上 面 的 URI 会 得 到 一 个 HTTP 401 错 误 提 示 。 熟 悉 HTTP 响 应 代码 的 读者 应 该 知道 401 表 示 认 证 失败 ， 也 就 是 用 户 没有 权限 访问 所 请 求 的 URI。 因 此 ， 在 没有 提供 
认证 信息 之 前 访问 上 面 的 URI 得 到 的 结果 如 下 : 


"errorMessage":"Authentication is required", 
"statusCode":401 


REST 一 个 很 大 的 特性 就 是 无 状态 ， 读 者 可 以 与 常规 系统 进行 对 比 来 理解 。 一 般 的 业务 系统 都 会 在 用 户 登 录 成 功 后 保存 用 户 信 息 到 HttpSession 对 象 中 ， 这 样 所 有 的 请 求 需要 使 用 用 户 信息 时 直接 从 
Session 对 象 中 获取 即 可 。REST 则 不 然 ， 其 无 状态 特性 把 一 个 WEB 请 求 与 其 他 的 请 求 完全 隔离 ， 资 源 请 求 者 需要 一 次 提供 资源 所 需 的 全 部 信息 ， 例 如 提供 用 户 认 证 信息 、 请 求 参 数 等 。 在 一 般 的 REST 架 构 服 
务 中 ， 都 会 把 用 户 认证 信息 放 在 请 求 信息 的 HTTP 头 部 (Header) ， 在 头 部 信息 中 添加 一 个 Base Authorization 认 证 , 或 者 在 URI 中 包含 用 户 名 和 密码 : 


http://kermit:000000@localhost:8080/aia/rest/... 


以 上 URI 中 kermit 为 用 户 名 ， 冒 号 后 面 的 000000 为 对 应 的 密码 。 


20.3 上 友 布 REST API 


Activiti 的 REST API 在 Restlet 基 础 上 进行 开发 ， 不 了 解 Restlet 的 读者 也 不 用 担心 。 如 果 仅 使 用 REST AP1， 只 需要 部 署 Activiti 官 方 提供 的 war 包 (需要 解压 缩 ) 到 Tomcat 或 其 他 容器 中 即 可 。 


从 官方 下 载 的 压缩 包 中 (例如 activiti-5.15.1.zip) 包含 一 个 名 称 为 wars 的 目录 ， 该 目录 包含 两 个 war 文 件 : activiti-explorer.war、activiti-rest.war。activiti-explorer 的 功能 在 前 面 已 经 介绍 ， 而 
activiti-rest 就 是 Activiti 的 REST APl。 


用 压缩 工具 把 activiti-rest.war 文 件 解压 复制 到 Tomcat 的 webapp 目 录 中 。 如 果 要 修改 REST APl 访 问 的 数据 库 ， 可 以 打开 activiti-rest/WEB-INF/classes/db.properties 文 件 修改 配置 ， 默 认 的 数据 库 配 
置 如 下 : 


db=h2 

jdbc.driver=org.h2.Driver 
jdbc.url=jdbc:h2:mem:activiti;DB CLOSE DELAY=-] 
jdbc.username=sa 

jdbc.password= 


转 说 明 与 activiti-explotet 一 样 ， 启 动 activiti-test 模 块 时 会 初始 化 用 户 数 据 。 


显然 使 用 内 存 数据 库 没 有 实际 意义 ， 所 以 把 数据 库 配 置 文件 中 的 jdbc.url 属 性 修改 为 第 17 章 示例 代码 的 jdbc 配 置 的 地 址 。 


jdbc.url=jdbc:h2:file:~/activiti-in-action-chapter17 


启动 容器 后 就 可 以 请 求 REST API 了 。 访 问 方式 有 很 多 种 ， 可 以 通过 浏览 器 直接 访问 ， 也 可 以 通过 Restlet、Apache Cxf、Apache HttpClient 访 问 。 


在 activiti-rest 应 用 中 配置 了 Restlet 的 Servlet 来 拦截 请 求 ， 相 关 配 置 如 下 : 


<!-—- Restlet adapter --> 
<servilet> 
<servlet-name>RestletServlet</servlet-name> 
<servilet-class> 
org.restlet .ext.serviet.ServerServiet 
</servlet-class> 
<init-param> 
<param-name>org.restlet.application</param-name> 
<param-value> 
org.activiti.rest.common.application 
.ActivitiRestApplication 


</param-value> 
</init-param> 
</servilet> 
<!-—- Catch all requests --> 
<servlet-mapping> 
<servlet-name>RestletServlet</servlet-name> 
<url-pattern>/service/*</url-pattern> 
</servlet-mapping> 


20.3.1 ”通过 浏览 器 访问 


在 浏览 器 中 输入 如 图 20-1 中 的 URL， 查 看 所 有 的 引擎 属性 ， 按 回 车 后 浏览 器 会 弹出 一 个 对 话 框 提示 输入 用 户 名 和 密码 验证 身份 ， 输 入 完 用 户 名 和 密码 后 点 击 “Login” 按 钮 ， 这 时 REST 模 块 给 出 了 响 
应 ， 如 图 20-2 所 示 。 


(localhost:8080/activiti-res x 


全 


3 x | 上 localhost:8080 /activiti-rest/service/management/properties 


Authentication Required 

rrorMessage: "Authentication is required", 

statusCode: 401 The server http:/ /localhost:8080 requires a username and 
password. The server says: Activiti Realm. 


User Name: |kermit 


Password: 


图 20-1 ”从 浏览 器 发 送 请 求 提示 验证 用 户 身份 


| DD localhost:8080/activiti-rest/service/management/properties 


next .dbids: "13701", 
schema.history: "create(5.15.1)", 
schema .version: 5.15.1" 


图 20-2 ” REST API 的 响应 结果 


从 图 20-2 中 可 以 看 出 ，REST API 给 出 了 正确 的 响应 结果 ， 用 JSON 数 据 格 式 展示 了 引擎 的 三 个 属性 ， 实 际 上 是 调用 了 ManagementService 的 getProperties() 方 法 ， 然 后 由 Restlet 转 换 为 JJON 字 符 串 输 


出 给 客户 端 。 


也 可 以 实验 一 下 在 HTTP 协 议 后 面 直接 传递 用 户 名 和 密码 验证 身份 ， 对 应 的 URL 如 下 : 


http://kermit:kermit@localhost:8080/activiti-rest/service/management/properties 


20.3.2 ”通过 HttpClient 访 问 


Apache HttpClient 是 常用 的 HTTP 协 议 访 问 工具 包 ， 简 单 的 几 行 代码 就 可 以 完成 一 次 请 求 并 接收 响应 结果 。 代 码 清单 20-1 列 出 了 通过 Apache HttpClient 访 问 REST API 的 代码 ， 用 来 读 取 引 警 的 配置 属 


由 


代码 清单 20-1 通过 HttpClient 访 问 REST API 


public class RestRequestByHttpClient { 
private static String REST URI = 
"http://localhost:8080/activiti-rest/service/management/properties"; 
public static void main(String[] args) throws IOException { 

// 设置 Base Auth 验 证 信息 

CredentialsProvider provider = new BasicCredentialsProvider () 

UsernamePasswordCredentials credentials = 

new UsernamePasswordCredentials ("kermit", "kermit"); 
provider.setCredentials (AuthScope.ANY, credentials); 
// 创建 HttpClient 


HttpClient client = HttpClientBuilder.create() 
.SetDefaultCredentialsProvider (provider) .build(); 
// 发 送 请 求 
HttpResponse response = client.execute (new HttpGet (REST URI)); 
HttpEntity entity = response.getEntity(); // 接收 响应 实体 
if (entity != null) { // 编码 转换 后 输出 到 控制 台 
String content = EntityUtils.toString(entity, "UTF-8"); 
System.out.println (content); 


执行 完 代码 清单 20-1 中 的 类 后 在 控制 台 打 印 了 REST API 返 回 的 结果 : 


fnext.dqbpidq":"101" "Schema.history" :"create (5.15)" "Schema.Vversion":"D.15"】} 


20.3.3 ”通过 Restlet 访 问 


Restlet 项 目 是 一 个 开源 轻 量 级 的 REST 框 架 实现 ， 功 能 比较 全 面 ， 所 以 在 企业 中 也 是 常用 的 REST 框 架 。 代 码 清单 20-2 列 出 了 通过 Restlet 访 问 REST API 的 代码 。 


代码 清单 20-2 ”通过 Restlet 访 问 REST API 


public class RestRequestByRestlet { 

private static String REST URI = 
"http://localhost:8080/activiti-rest/service/management/properties"; 

public static void main(String[] args) throws IOException { 

// 创建 Resource 对 象 
ClientResource resource = new ClientResource (REST URI); 
// 设置 Base Auth 认 证 本 

resource.setChallengeResponse (ChallengeScheme.HTTP BASIC, “kermit", "kermit"); 
Representation representation = resource.get (); 

ObjectMapper mapper = new ObjectMapper () ， 
// 把 文本 转换 为 JSON 格 式 对 象 
JsonNode jsonNode = mapper.readTree (representation.getSstream()); 


// 循环 输出 响应 内 容 


Iterator<String> fieldNames = jsonNode.getFieldNames () ， 

while (fieldNames.hasNext()) { 
String fieldName = fieldNames.next ();} 
System.out.println(fieldName + " : "+ jsonNode.get (fieldName)); 


执行 完 代码 清单 20-2 中 的 类 后 输出 结果 如 下 : 


next.dbid : "101" 
schema.history : "create(5.15)" 
schema.version : "5.15" 


20.3.4 ”通过 Apache CXF 访 问 


Apache CXF 是 目前 比较 流行 的 一 个 开源 Service 框 架 。CXF 可 以 使 用 WSDL 标 准 定义 并 支持 多 种 消息 格式 ， 例 如 SOAP、XML/HTTP 等 。CXF 除 了 支持 标准 的 SOAP RPC 的 Web Service 之 外 ， 还 可 以 发 
布 REST 架 构 的 Web Service (Restful 风 格 ) 。 代 码 清单 20-3 列 出 了 使 用 Apache CXF 访 问 REST API 的 代码 。 


代码 清单 20-3 ”通过 Apache CXF 访 问 REST API 


public class RestRequestByCxf { 
private static String REST URI = 
"http://localhost:8080/activiti-rest/service/management/properties"; 
public static void main(String[] args) throws IOException { 
// 创建 client 对 象 
WebClient client = WebClient.create (REST URI); 
// Basic Auth 身 份 认 证 是 
String auth = "Basic " + Base64Utility.encode ("Kkermit :kermit" .getBytes () ) ， 
client.header ("Authorization", auth); 
// 获取 响应 内 容 
Response response = client.get(); 
InputStream stream = (InputStream) response.getEntity(); 
// 转换 并 输出 响应 结果 
StringWriter Writer = new StringWriter () ， 
IOUtils.copy (Stream writer, "UTF-8");}; 
String respText writer.toString (); 
System.out.println (respText); 


代码 清单 20-3 执 行 完 成 后 的 结果 如 下 : 


{"next.dbid":"101","schema.history":"create(5.15)","schema.version":"5.15"} 


20.4 集成 REST API 


假如 某 个 应 用 以 嵌入 式 集成 了 Activiti 引 警 ， 除 了 在 内 部 调用 引擎 接口 外 还 需要 对 外 提供 接口 服务 ， 此 时 REST API 就 派 上 了 用 场 ， 只 需要 简单 配置 即 可 对 外 提供 标准 的 REST 服 务 接口 ， 同 时 也 节省 了 开 


读 过 源码 的 读者 会 发 现 源码 目录 中 和 REST 有 关 的 模块 有 以 下 三 个 : 
:activiti-common-test， 公 共 对 象 以 及 工具 类 。 
:activiti-test， 有 具体 的 API 实 现 及 定义 。 
-activiti-webapp-fest2， 依 赖 以 上 两 个 模块 ， 可 以 打包 成 wa 部署 到 容器 中 发 布 。 
从 官方 下 载 的 压缩 文件 中 的 activiti-rest.war 就 是 由 activiti-webapp-rest2 模 块 打包 的 结果 。 


要 把 REST API 集 成 到 现 有 的 应 用 中 只 需要 把 activiti-rest-5.x.jar 和 activiti-common-rest-x.jar 复 制 到 应 用 的 lib 目 录 或 使 用 Maven 配 置 依赖 (参考 chapter20-rest 目 录 中 的 pom.xml 中 定义 的 依赖 ) ， 然 
后 在 应 用 的 web.xml 中 配置 相关 的 Servlet 映 射 即 可 发 布 REST 接 口 。 


可 以 从 官方 源码 或 解压 的 activiti-rest.war 中 复制 以 下 两 个 文件 到 项 目 源 码 的 资源 根 目 录 中 ， 如 图 20-3 所 示 。 


下 [=resources 
> diagrams 
> activiti=context.xml 


[i db.properties 
[i log4j.properties 
Pb 团 webapp 
be 站 test 
jl chapter20-rest.iml 
Mm pom.xml 


图 20-3 ”包含 了 REST API 所 需 的 配置 文件 
activiti-context.xml， 引 掌 的 配置 文件 (用 Spring 代 理 引 掌 ) 。 
. db.properties， 引 擎 数据 库 属性 配置 文件 。 
文件 activiti-context.xml 不 需要 修改 ， 当 然 也 可 以 添加 自己 的 配置 信息 ， 要 配置 数据 库 可 以 修改 db.properties 文 件 。 


在 准备 好 了 引擎 的 配置 文件 后 ， 接 下 来 要 在 应 用 的 web.xml 中 加 入 REST API 的 相关 配置 ， 包 括 Activiti 引 擎 上 下 文 初始 化 监听 器 (ActivitiServletContextListener) 以 及 servlet 映射， 具体 配置 如 下 : 


<listener> 
<listener-class> // 上 下 文 监听 器 
org.activiti.rest.common.servilet 
.ActivitiServletContextListener 
</listener-class> 
</listener> 


<!-- Restlet 适配器 --> 
<servilet> 
<servlet-name>RestletServlet</servlet-name> 
<serviet-class> 
org.restlet .ext.servlet.ServerServlet 
</servlet-class> 
<init-param> 
<! 一 定义 路 由 --> 
<param-name>org.restlet.application</param-name> 
<param-value>org.activiti.rest.service.application 
.ActivitiRestServicesApplication 
</param-value> 
</init-param> 
</servlet> 
<!-- Catch all requests 一 -> 
<servilet-mapping> 
<servilet-name>RestletServlet</servlet-name> 
<url-pattern>/service/*</url-pattern> // 接口 访问 基 路 径 
</servlet-mapping> 


20.4.2 ”通过 Ajax 访问 


在 20.3 节 中 介绍 了 可 以 使 用 Java 代 码 访问 REST 接 口 ， 还 可 以 使 用 前 端 技 术 Javascript 来 访问 ， 这 样 只 要 有 浏览 器 就 可 以 向 引擎 发 送 请 求 ， 下 面 的 代码 列 出 了 通过 jQuery.ajax 读 取 引 警 属 性。 
S.a]jax({ 
type: "get™, 


url: "http://localhost:8080/chapter20-rest/ 
service/management/properties", 
dataType: "json", 
beforeSend: function (xhr) { // 设置 认证 信息 
var token = 'kermit:000000'» 
Var hash = Base64.encode (token); 
Var baseAuth = "Basic " + hash; 
xhr.setRequestHeader ('Authorization', baseAuth); 


}, 
contentType: "application/json", 
success: function(json) { 
$.each(json, function(k, v) 1 
S(T 
Hem kK 
}) .appendTo ('#resp'); 


在 以 上 代码 中 ，beforesend 定 义 的 functioni 用 于 设置 认证 信息 ， 在 通过 Base64 函 数 加 密 后 设置 到 XmlIHttpRequest 对 象 的 header 中 ， 请 求 的 参数 与 返回 的 结果 类 型 均 为 JJON 类 型 。 


在 启动 本 章 示例 代码 后 ， 在 浏览 器 中 打开 http://localhost:8080/chapter20-rest， 单 击 图 20-4 中 的 “Ajax 访问 ”按钮 后 显示 了 引擎 的 属性 信息 。 


[ localhost:8080/chapter20-rest/ 


sa next,dbid: 13701 
es。 Schemahistory: create(5.135.1) 
sa scherma.version: $.15.1 


图 20-4 ”通过 Ajax 访问 REST API 


要 实现 Ajax 跨 域 访问 ， 需 要 使 用 JSONP 方 式 ， 不 过 由 于 JSONP 不 支持 Basic Authorization 认 证 ， 因 此 需要 自行 实现 ， 例 如 在 Restlet 中 配置 支持 跨 域 (Access-Control-Allow-Origin) ， 或 者 替换 原 有 
的 Basic Authorization 身 份 认证 方式 。 


20.5 “完整 示例 


本 节 内 容 将 使 用 REST API 完 成 一 个 完整 的 流程 示例 ， 涉 及 几 个 典型 的 操作 ， 例 如 部 署 流程 、 查 询 流程 定义 、 任 务 查询 、 任 务 完成 等 。 


本 节 的 示例 代码 以 Apache CXF 作 为 访问 REST API 的 客户 端 。 由 于 示例 涉及 的 内 容 比 较 多 ， 因 此 会 分 段 介 绍 ， 完 整 的 示例 代码 可 以 查看 本 书 配套 资源 中 的 文件 chapter20- 


rest/src/main/java/me/kafeitu/activiti/chapter20/rest/RestRequestTandem.java。 


在 运行 示例 代码 之 前 先 启动 Activiti 官 方 提供 的 activiti-rest.war 服 务 ， 示 例 代码 中 涉及 REST_BASE_URI 的 地 方 均 使 用 下 面 的 常量 定义 : 


private static final String BASE REST URI = 
"http://localhost:8089/activiti-rest/service/"; 


代码 清单 20-4 列 出 了 几 个 通用 方法 辅助 示例 ， 例 如 创建 WebClient 对 象 和 结果 输出 ， 方 便 读者 分 析 请 求 、 响 应 的 JSON 数 据 。 


代码 清单 20-4 ”完整 示例 中 几 个 公共 方法 


// 创建 Client 

private static WebClient createClient (String uri) { 

WebClient client = WebClient.create (BASE REST URI + uri); 

String auth = "Basic " + Base64Utility.encode ("kermit:kermit".getBytes ()); 
client.header ("Authorization", auth); 

return client; 


} 

// 打印 发 送 请 求 的 JSON 数 据 

private static void printJsonString(String phase, String json) { 
System.out.println("\ n+++ 发 送 请 求 [" + phase + "] +++0) ， 
System.out.println (json); 


} 
// 打印 输出 结果 
private static JsonNode printResult (String phase, Response response) { 
System.out.println("\n=== " + phase + " ==="); 
try { 
InputStream stream = response.getEntity(); 
int available = stream.available (); 
e 
U 


if (available == 0) { 
System.out.println("nothing returned, response code: " + response.getStatus ()); 
return null; 


JsonNode responseNode = objectMapper.readTree (stream); 

if (formateOutputJson) { 
System.out .Println(objectMapper .writerWithDefaultPrettyPrinter () 

.writeValueAsString (responseNode) ) ; 


} else { 
System.out .Println(objectMapper .writeValueAsString (responseNode) ) 


} 
return responseNode; 

} catch (IOException e) { 
System.err.println("catch an exception: " + e.getMessage()); 
e.printStackTrace () ; 


return null; 


20.5.1 ”部 署 流 程 


部 署 流程 对 应 的 资源 路 径 为 “repository/deployments”,， 支持 GET、POST 请 求 类 型 ， 代 码 清单 20-5 列 出 了 部 署 流程 的 示例 代码 。 


代码 清单 20-5 ”部 署 流程 (创建 Deployment 对 象 ) 


private static void deployLeave() { 


WebClient client = createClient ("repository/deployments"); // 创建 WebClient 对 象 
InputStream resourceAsStream = RestRequestTandem.class.getClassLoader () #1] 

.getResourceAsStream("diagrams/leave.bpmn"); // 获取 bpmn 文 件 资源 
client.type ("multipart/form-data"); // 设置 请 求 内 容 类 型 #2 
ContentDisposition cd = new ContentDisposition 

("form-data;name=bpmn; filename=leave .bpmn"); #3-1 

Attachment att = new Attachment ("leave.bpmn", resourceAsStream, cqd); #3-2 
Response response = client.post (new MultipartBody (att)); // 以 POST 方式 发 送 请 求 #4 
printResult ("部 署 流 程 "，response); // 转换 并 输出 响应 结果 #5 


} 


代码 清单 20-5 的 作用 是 上 传 文件 流 到 REST 服 务 ， 这 与 20.3.4 节 使 用 的 API 有 一 些 差别 : #1 处 从 classpath 中 读 取 BPMN 文 件 流 ; #2 处 设置 请 求 的 内 容 类 型 ， 由 于 本 例 涉及 文件 上 传 ， 因 此 必须 声明 请 求 的 
header 属 性 “Content-Type” 为 “multipart/form-data”; #3-1 处 定义 了 内 容 的 类 型 (name 属 性 必须 定义 ， 否 则 REST API 会 抛 出 NullPointerException 异 常 ) ， 接 着 在 #3-2 处 定义 了 附件 对 象 ; #4 处 
把 附件 作为 请 求 的 Body 以 POST 请 求 友 送 给 REST 服 务 ; #5 处 把 相应 结果 打印 在 了 控制 台 ， 结 果 如 下 : 


=== 部 署 流程 = 一 
{ 


人 。 "1004"™, 

"name" : "leave.bpmn", 

"deploymentTime™" : "2014-06-14T07:33:50.329+0000", 

"Category™" : null, 

"url" : "http://localhost:8089/activiti-rest/service/repository/deploy-ments/1004", 
"tenantId™ : "" 


结果 是 一 个 标准 的 JSON 格 式 数 据 ， 包 含 了 Deployment 的 几 个 主要 属性 ， 其 中 “url” 的 值 是 获取 的 单个 Deployment 对 象 详细 的 URL。 
20.5.2 ”查询 Deployment 


查询 Deployment 与 部 署 流程 的 资源 路 径 相同 ， 只 不 过 查询 Deployment 使 用 的 是 POST 类 型 的 请 求 ， 可 以 附加 查询 条 件 ， 例 如 名 称 (name) 、 分 类 (category) 等 。 代 码 清单 20-6 列 出 了 部 署 流程 的 
示例 代码 。 


代码 清单 20-6 ”查询 Deployment 


private static void queryDeployment() { 
WebClient client = createClient ("repository/deployments"); 
Response response = client.get(); // GET 请 求 类 型 
// 转换 并 输出 响应 结果 
printResult (" 查 询 Deployment"，Ttesponse) ; 


代码 清单 20-6 的 输出 结果 如 下 : 


"qata- 二 渤 
于 国史 “ "1004"™, 
"name" : "leave.bpmn", 
"deploymentTime™" : "2014-06-14T07:33:50.329+0000™, 
"Ccategory™" : null, 
"url" : "http://localhost:8089/activiti-rest/service/repository/deploy-ments/1004", 
"tenantId™ : "" 

} ]， 

total™ : 1 

vstart™ 3 07 

1 SOEtY “ A 5 

"Order™" : "asc", 

"size" : 1 


代码 清单 20-6 的 输出 结果 与 代码 清单 20-5 相 比 多 出 了 一 些 和 分 页 有 关 的 属性 ， 这 说 明 可 以 分 页 查询 数据 。 通 用 的 分 页 查询 参数 见 下 面 的 列表 : 
“sort: 排序 字段 名 称 。 


: order: 排序 类 型 ， 升 序 (asc) 、 降 序 (desc) 。 


:statt: 起 始 记 录 值 ， 默 认 值 为 0。 
.size: 每 一 页 显示 的 数量 ， 默 认 值 为 10。 
20.5.3 ”查询 流程 定义 


查询 流程 定义 与 查询 Deployment 类 似 ， 只 不 过 资源 路 径 不 同 而 已 。 代 码 清单 20-7 列 出 了 查询 流程 定义 的 示例 代码 。 


代码 清单 20-7 ”查询 流程 定义 


private static JsonNode queryProcessDefinitions() { 
WebClient client = createClient ("repository/process-definitions"); 
Response response = client.get(); 
// 转换 并 输出 响应 结果 
return printResult (" 查 询 流程 定义 "，response) : 


代码 清单 20-7 的 输出 结果 如 下 : 


一 - 查询 流程 定义 一 
"qata" 
"id" : "leave:1:1007"™, 
"url" : "http://localhost:8089/activiti-rest/service/repository/process-definitions/leave%$3A1%3A1007", 
"key" 。 "leave", 
"version™ : 1, 
"name" : "请 假 流程 -动态 表单 "， 
"description"” : "请 假 流 程 演示 -动态 表单 "， 
"deploymentId™" : "1004"™, 
"deploymentUrl" : "http://localhost:8089/activiti-rest/service/repository/deployments/1004", 
"resource" : "http://localhost:8089/activiti-rest/service/repository/deployments/1004/resources/leave.bpmn", 
"diagramResource" : "http://localhost:8089/activiti-rest/service/repository/deployments/1004/resources/leave.leave.png", 
"category™" : "http://www.kafeitu.me/activiti/leave", 
"graphicalNotationDefined" : true, 
"suspended" : false, 
"startFormDefined" : false 
} 1], 
"total™ : 1, 
"estart™ 3 0O, 
RSTO ei “ "name", 
"order™" : "asc", 
"size" : 1 


代码 清单 20-7 执 行 后 输出 的 数据 包含 了 分 页 信息 ，“data” 属 性 为 流程 定义 对 象 的 数据 集合 ， 每 一 个 流程 定义 都 包含 了 必要 的 几 个 属性 以 及 流程 定义 的 XML、 图 片 路 径 。 


urls: "http: oealt 
ontentUrl: "http:/ /local 
mediaType: "image/png", 
tp "regource" 


图 20-5 ”流程 定义 的 图 片 资源 信息 


再 次 访问 图 20-5 中 所 示 “contentUrl” 属 性 值 后 即 可 获取 图 片 文件 ， 如 图 20-6 所 示 。 


请 求 被 驶 回 后 员工 
可 以 选择 继续 
或 者 取消 本 次 


时 


申请 
申请 


图 20-6 ”通过 REST 服 务 获取 的 流程 图 


20.5.4 ”启动 流程 


启动 流程 的 资源 路 径 为 “runtime/process-instances”， 支 持 GET、POST 类 型 的 请 求 。GET 请 求 可 以 查询 流程 列表 (支持 分 页 ) ，POST 请 求 可 以 启动 一 个 流程 实例 。 


启动 流程 的 方式 有 多 种 : 通过 流程 定义 ID、 通 过 流程 KEY、 通 过 触发 消息 (Message Start Event) 。 本 节 以 流程 定义 ID 的 方式 启动 流程 演示 请 求 REST 服 务 的 过 程 。 要 通过 流程 定义 ID 启 动 流 程 ， 首 先 
要 得 到 流程 定义 1D。 假 设 每 次 启动 的 都 是 用 最 新 版 本 的 流程 ， 代 码 清单 20-8 列 出 了 根据 流程 KEY 读 取 最 新 版 本 流程 定义 1D 的 代码 。 


代码 清单 20-8 根据 读 取 流程 定义 ID 


public static void main(String[] args) throws IOException { 
// 查询 到 最 新 版 本 的 请 假 流 程 ， 然 后 从 结果 集中 获取 data 数 据 
JsonNode jsonNode = queryLastVersionOfLeaveProcess () ; 
ArrayNode data = (ArrayNode) jsonNode.get ("data"); 
JsonNode next = data.iterator() .next () ， 

String latestVersionId = next.get ("id") .asText () ， 

System.out .println ("latestVersionId=" + latestVersionId); 


} 
private static JsonNode queryLastVersionOfLeaveProcess() 1 
WebClient client = createClient ("repository/process-definitions?key=leave&latest=true"); 
Response response = client.get(); 
// 转换 并 输出 响应 结果 
return printResult ("查询 最 新 版 本 的 请 假 流程 定义 "，response);}; 


执行 代码 清单 20-8 后 输出 如 下 结果 ， 从 中 可 以 看 出 最 新 版 本 的 流程 定义 ID 为 “leave:1:1007”。 


// 省 略 了 JSON 输 出 ， 和 代码 清单 20-7 的 输出 结果 一 样 


latestVersionId=leave:1:1007 


20.5.1 节 部 署 的 请 假 流 程 是 一 个 动态 表单 类 型 ， 所 以 需要 在 请 求 启动 流程 服务 时 提供 启动 表单 字段 值 ， 对 应 的 资源 路 径 为 “form/form-data”， 可 以 用 来 获取 指定 流程 定义 或 者 任务 的 表单 字段 配置 。 
代码 清单 20-9 列 出 了 获取 指定 流程 定义 的 启动 表单 。 


代码 清单 20-9 ”获取 指定 流程 定义 的 启动 表单 


// 参数 processDefinitionId 由 代码 清单 20-8 中 的 latestVersionId 变 量 提供 

private static void queryProcessStartForm(String processDefinitionId) {{ 

String url = "form/form-data?processDefinitionId=" + processDefinitionIgd; 
WebClient client = createClient (url); 

Response response = client.get(); 


printResult ("获取 流程 的 启动 表单 属性 "， 


response); 


} 


执行 代码 清单 20-9 的 结果 如 下 ， 其 中 “formProperties” 数 组 为 启动 流程 的 表单 字段 定义 


=== 获取 流程 的 启动 表单 属性 一 = 
{ 


'formKey™" : null, 

"deploymentId™" : "1004"™, 

"processDefinitionId" : "leave:1:1007", 

"processDefinitionUrl™" : "http://localhost:8089/activiti-rest/service/repository/process-definitions/leave%$3A1%3A1007", 
"taskId™" : null, 

'taskUrl™ : nul 


formProperties™" : [ { 
"id" : "star 
"mame™ : "请 假 台 日 期 "， 
"type" 。 "date™ 7 
"value" : null, 
"reaaqable" : true, 
"writable" : true, 

"required" : true, 
"datePattern™" : "yyyy-MM-dd", 
"enumValues" : [| 

}, 1{ 

"id" : "endDate", 

"name" : "请 假 结 束 日 期 "， 

"type" 。 "aqate"， 

"Value" : ma ly 

"readable™" : true, 

"writable" : true, 

"required™" : true, 
"datePattern™" : "yyyy-MM-dd", 
"enumValues" : [ |] 

}, { 

Tid 3 "eason', 
"name" : "请 假 原因 "， 
"type"™ “ vstrinog", 
"value™ : null, 
"readable™" : true, 
"writable" : true, 
"required™" : true, 
"datePattern™" : null, 
"enumValues" : [ |] 


} ] 


现在 可 以 根据 获取 的 表单 字段 发 送 启 动 流 程 请 求 了 (资源 路 径 “form/form-data”) ， 在 内 部 调用 FormService#getRenderedStartForm。 代 码 清单 20-10 列 出 了 通过 REST 的 表单 服务 模块 启动 流程 
的 示例 代码 。 


代码 清单 20-10 ”启动 流程 


动态 表单 


private static JsonNode startProcessInstance (String processDefinitionId) throws IOException { 
WebClient client = createClient ("form/form-data"); 
client.type ("application/json;charset=UTF-8"); ”// 内 容 类 型 必须 设置 
Map<String, Object> parameters = new HashMap<String, Object> () ， #1-S 
// parameters.put ("processDefinitionKey", "leave"); #1-—1 
parameters.put ("processDefinitionId", processDefinitionId); 
List<Map<String, String>> variables = new ArrayList<Map<String, String>>() 7 
Map<String, String> var = new HashMap<String, String>(); 
var.put ("id",， "startDate"); // 请 假 开始 日 期 
var.put ("value", "2014-02-03"); 
variables.adgd (var); 
Var = new HashMap<String, String>() 
var.put ("id", "endDate"); // 请 假 结束 日 其 
var.put ("value", "2014-02-05"); 
variables.add (var); 
Var = new HashMap<String, String>(); 
var.put ("id"，"reason"); // 请 假 原 医 
var.put ("value"，" 旅 游 ") ; 
variables.add (var); 


parameters.put ("properties"，variables); // 设置 表单 属性 #1 一 
String body = objectMapper. ii 让 the faultPrettyPrinter () #2-S 
.writeValueAsString (parameters); 
printJsonString ("启动 请 假 流程 "，body); #2 一 EE 


Response response = client.post (body); 
return printResult ("启动 请 假 流程 "，response); 


#1 处 分 别 用 Map 对 象 设置 了 三 个 表单 字段 的 值 ， ie 合作 为 属性 “properties” 的 值 ; #2-S 处 利用 jackson 工 具 把 一 个 Map 对 象 转换 成 格式 化 的 JSON 字 符 ， 参 见 下 面 执行 结果 
中 的 “发 送 请 求 [启动 请 假 流程 ]j” 部 分 ; 最 后 把 JSON 字 符 串 作为 请 求 内 容 通 过 POST 请 求 发 送 给 REST 服 务 ， 返 回 了 启动 成 功 后 的 流程 实例 JSON 数 据 。 代 码 清单 20-10 的 执行 结果 如 下 : 


+++ 发 送 请 求 [启动 请 假 流程 ] +++ 
{ 


"properties™" : [ { 
Me "startDate", 
Value" : "2014-02-03" 


"id" : "endDate", 
Value" : "2014-02-05" 


id : "reason', 
value" : "旅游 " 


"processDefinitionId" : "leave:1:1007" 


} 
一 = 启动 请 假 流程 一 
{ 


六 . "1008™, 

"url" : "http://localhost:8089/activiti-rest/service/runtime/process-instances/1008", 
"businessKey" : null, 

"suspended" : false, 
"processDefinitionId" : "leave:1:1007", 

"processDefinitionUrl" : "http://localhost:8089/activiti-rest/service/repository/process-definitions/leave%3A1%3A1007", 
"activityld" : "deptLeaderAudit", 

"variables™" : [ ]， 

"tenantId™ : "" 


} 


上 面 的 例子 只 是 通过 表单 启动 流程 的 一 种 方式 ， 如 果 流 程 没有 使 用 动态 表单 或 不 需要 传递 表单 字段 值 ， 可 以 使 用 普通 的 流程 启动 方式 。 在 向 路 径 为 “runtime/process-instances” 的 资源 发 送 POST 请 
求 时 就 表示 要 启动 一 个 流程 ， 可 以 使 用 不 同 的 方式 ， 例 如 : 流程 定义 KEY (processDefinitionKey) 、 流 程 定义 ID (processDefinitionld) 、 消 息 名 称 (message) 。 详 细 的 参数 可 以 参考 用 户 手册 


中 “Start a process instance” 部 分 的 介 


20.5.5 ” 读 取 流程 变量 


读 取 流程 变量 的 资源 路 径 为 “runtime/process-instances/{processInstanceld}variables”， 在 使 用 时 把 “{processinstanceld}” 更 换 成 具体 的 流程 实例 ID 即 可 。 代 码 清单 20-11 列 出 了 读 取 流程 变量 
的 示例 代码 。 


代码 清单 20-11 ” 读 取 流程 变量 


private static void listProcessInstanceVariables (String ProcessInstanceId) { 
String Url = "runtime/process-instances/" + processInstancelId + "/variables"; 
WebClient client = createClient (url); 
Response response = client.get(); 
printResult (" 读 取 流程 实例 [" + processInstanceId + "] 的 变量 "，response)，; 


} 


代码 清单 20-11 的 执行 结果 如 下 。 结 果 集 中 每 一 个 变量 分 别 用 name、type、value、scope 描 述 了 变量 的 属性 。 


一 = 读 取 流程 实例 [1008] 的 变量 一 = 
[4 


"name" : "startDate", 
"type"™ "date™ 
"value" : "2014-02-02T16:00:002Z"™, 
"SCcope"” : "local" 
}» 1{ 
"name" : "applyUserId", 
"type" “ 1 string" 
"Value" : "kermit", 
"Scope"” : "local" 
zx 
"name" : "reason"., 
"七 YPe 7" 。 1 string" 
nvalue" : "旅游 " 人 
"scope™" : "local" 
}, { 
"name" : "endDate", 
"type"™ “ vqdate" 5 
"value" : "2014-02-04T16:00:002Z"™, 
"Scope"” : "local" 


} ] 


20.5.6 ”查询 任务 


任务 根据 签收 状态 可 以 分 为 两 种 : 未 签收 任务 、 已 签收 任务 。 这 两 种 任务 的 REST 服 务 的 资源 路 径 均 为 “runtime/tasks”， 但 使 用 的 参数 不 同 而 已 。 关 于 具体 的 查询 过 滤 参 数 ， 读 者 可 以 参考 用 户 手 册 
中 的 “List of tasks” 部 分 


在 请 假 流程 中 ，“ 部 门 领导 审批 ”和 “人 事 审批 ” 均 分 配给 不 同 的 组 (group) ， 所 以 在 过 滤 时 可 以 选择 使 用 候选 人 ID 或 候选 组 ID 属 性 。 对 于 “销假 ”节点 ， 因 为 不 需要 签收 而 直接 分 配给 流程 发 起 
人 ， 所 以 要 根据 办 理 人 (assignee) 进行 过 滤 。 下 面 分 别针 对 这 两 种 类 型 进行 介绍 


代码 清单 20-12 列 出 了 根据 候选 组 查询 任务 的 示例 代码 ， 使 用 的 过 滤 参 数 名 称 为 “candidateGroup” 


代码 清单 20-12 ”根据 候选 组 查询 任务 


public static void main(String[] args) { 
JsonNode jsonNode = queryCandidateTask ("deptLeader"); 
data = (ArrayNode) jsonNode.get ("data"); // 以 下 的 代码 用 来 获取 任务 的 ID 和 名 称 
next = qata.iterator () .next () ; 
String deptTaskId = next.get ("id") .asSTexX: 
String taskName = next.get ("name") .asTex 
assert taskName .equals ("部 门 领导 审批 ")，; 


(二 人 


} 
private static JsonNode queryCandidateTask (String groupId) { 
WebClient client = createClient ("runtime/tasks?candidateGroup=" + groupId); 
Response response = client.get(); 
return printResult (" 读 取 组 [" + groupId + "] 的 任务 "，response); 


代码 清单 20-12 的 输出 结果 如 下 : 


=== 读 取 组 [deptLeader] 的 任务 === 
{ 


"data™ : [ { 
| “ "TIOLO™. 


WEL 
"OwnNer™ 
"assign 
"delega 
mw name 1 


TREE 


: null, 
ee™" : mul] 
tionSstate" 
: "部 门 领导 


-lb 


-本 
"description" 
"createTime" 
"dueDate" 
"priority 
"suspended" 


: nul 
2 50， 
: fal 


2 
1, 


taskDef 


ini 


} ]， 


"total" 
"start" 


全 加 七 二 


"Oorder" 


"size" 


代码 清单 20-13 中 的 方法 用 来 查询 指定 用 户 的 待 办 任务 ， 与 代码 清单 20-12 不 同 ， 其 过 
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dd 
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ELONUELY 
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:1007 


代码 清单 20-13 ”根据 办 理 人 查询 任务 


public static void main(String[] args) 


A 


//] 


{ 


queryAssignedTask ("kermit"); 


} 


private static JsonNode queryAssignedTask (String userI 
WebClient client = createClient ("runtime/tasks?assignee=" + userI 


4-06-14T07:33:50.497+0000™, 


: "deptLeaderAudit", 


ocalhost:8089/activiti-res 


localhost:8089/activit 


Response response = client.get(); 


return printResult (" 读 取 用 户 [" + userI 


代码 清单 20-13 的 输出 结果 与 代码 清单 20-12 的 输出 结果 类 似 ， 


20.5.7 


20.5.6 小 节 介 绍 了 如 何 查 询 候选 任务 ， 本 小 节 接 着 介绍 如 何 签收 候选 任务 。 在 REST API 中 ， 
径 为 “runtimey/tasks/ftaskld}”。 有 关 任 务 动作 的 详细 参数 可 以 参考 手册 的 “Task actions” 部 分 ， 值 和 


的 HTTP 状 态 码 判断 i 


签收 任务 


青 求 的 


吉 果 。 


代码 清单 20-14 列 出 了 签收 任务 的 示例 代码 。 


代码 清单 20-14 


public static void main(String[] args) 
claimTask (taskI 


} 


签收 任务 


private s 
WebClient client = createClient ("run 


La 


"kermit" 


qd, 


{ 
) 7 


tic woid claimTask{(String taskI 


d, String us 


localhost:8089/activiti-rest/service/repository/process-dei 


d) { 


ocalhost:8089/activiti-rest/service/runtime/tasks/1019", 


t/service/runtime/executions/1008", 


ti-rest/service/runtime/process-instances/1008", 


finitions/leave%$3Al%3A1007", 


过 滤 参 数 由 “candidateGroup” 换 成 了 “assignee”。 


d); 


qd + 器 的 任务 "，zesponse) 


读者 可 以 自行 运行 示例 查看 。 


Id) 


公正 


签收 (claim) 、 提 交 (complete) 、 委 派 (delegate) 等 操作 都 归属 于 任务 动作 (task action) ， 资 源 路 
导 注 意 的 是 这 些 请 求 均 没有 响应 内 容 ， 而 是 根据 是 否 成 功 有 不 同 的 HTTP 状 态 码 ， 在 使 用 时 根据 响应 


O 


throws Exception { 


time/tasks/" + taskI 


d); 


client.type ("application/json;charset=UTF-8"); 

Map<String, Object> parameters = new HashMap<String, Object> () ， 

parameters.put ("action", "claim"); // 设置 动作 类 型 为 claim 

parameters.put ("assigqnee", userId); // 设置 签收 动作 的 人 员 ID 
String body = objectMapper.writerWithDefaultPrettyPrinter () 

.writeValueAsString (parameters); 

printJsonString ("签收 任务 [" + taskId + "]",， body); 

Response response = client.post (body); 

printResult ("签收 任务 [" + taskId + "]",， response); 


代码 清单 20-14 的 输出 结果 如 下 ， 注 意 
+++ 发 送 请 求 [签收 任务 [1025] ] +++ 
{ 
"action'" : "claim", 
"assignee'" : "lily" 
} 
=== 签收 任务 [1025] === 
nothing returned, response code: 2 


20.5.8 ”完成 任务 


完成 任务 与 签收 任务 类 似 ， 


AN 
资源 


资源 


代码 清单 20-15 “完成 任务 


AS 


00 


签收 任务 [1025]” 部 分 的 输出 结 


路 径 同 样 为 “runtime/tasks/{taskldy” 


， 响 应 的 状态 码 为 200， 这 说 明 任务 签收 动作 执行 成 功 。 


， 不 同 的 是 action 参 数 为 “complete”。 代 码 清单 20-15 列 出 了 完成 任务 的 示例 代码 。 


public static void main(String[] args) { 
List<Map<String, String>> variables = new ArrayList<Map<String, String>>(); 
Map<String, String> var = new HashMap<String，String>(); // 变量 
var.put ("name", "deptLeaderApproved"); 
var.put ("value", "true"); 
var.put ("type", "string"); 
variables.add (var); 
// 变量 dqeptTaskIgd 的 值 来 源 于 代码 清单 20-12 
completeTask (deptTaskId, taskName, variables); 
} 
private static void completeTask (String taskId, String taskName, 
List<Map<String, String>> variables) throws IOException { 
WebClient client = createClient ("runtime/tasks/" + taskId); 
client.type ("application/json; charset=UTF-8");} 
Map<String, Object> parameters = new HashMap<String, Object>(); 
parameters.put ("action", "complete"); // 任务 动作 类 型 为 complete 
if (variables != null) { 
parameters.put ("variables"，variables); // 设置 变量 
} 
String body = objectMapper.writerWithDefaultPrettyPrinter () 
.writeValueAsString (parameters); 
printJsonString ("完成 任务 [" + taskId + "-" + taskName + "]", body); 
Response response = client.post (body); // POST 类 型 请 求 
printResult ("完成 任务 [" + taskId + "-" + taskName + "]", response); 


代码 清单 20-15 的 执行 结果 如 下 ， 同 样 也 是 没有 内 容 返 回 ， 是 否 成 功 需要 根据 HTTP 响 应 码 来 判断 。 


+++ 发 送 请 求 [完成 任务 [1019- 部 门 领导 审批 ] ] +++ 
{ 


"taskId™" : "1019", 

"properties™" : [ { 
"name" : "deptLeaderApproved", 
"value™” : "true" 


}] 


} 
=== 完成 任务 [1019- 部 门 领导 审批 ] === 
nothing returned, response code: 200 


REST API 中 涉及 的 变量 定义 使 用 统一 如 下 格式 : 


"name" : "variableName", 

"value" : "variableValue", 

"valueUrl™" : "http://http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15030/0EBPS/Text/..." 
"scope™" : "local"™, 

"type™" : "string" 


20.5.9 ”查询 历史 数据 
前 面 几 个 示例 都 是 与 运行 中 (runtime) 有 关 的 ， 本 小 节 简 单 介绍 一 下 与 历史 (history) 有 关 的 示例 。 以 查询 历史 流程 实例 为 例 ， 见 代码 清单 20-16。 


代码 清单 20-16 ”完成 任务 


private static JsonNode queryHistoricProcessInstance() { 

String url = "history/historic-process-instances?includeProcessVariables=true"; 
WebClient client = ee 

Response response = client .ge 
return ee response); 


代码 清单 20-16 的 输出 结果 如 下 ，url 中 的 “includeProcessVariables=true” 表 示 查 询 历史 流程 实例 时 附带 相关 的 流程 实例 变量 。 有 关 历 史 对 象 查询 的 参数 介绍 可 参看 用 户 手 册 的 “History” 部 分 


一 查询 历史 流程 实例 一 - 
{ 
"data™" : [ { 
内 次 @ | 和 "L008 
"url" : "http://localhost:8089/activiti-rest/service/history/historic-process-instances/1008", 
"businessKey"” : null, 
"processDefinitionId" : "leave:1:1007", 
"processDefinitionUrl™" : "http://localhost:8089/activiti-rest/service/repository/process-definitions/leave%$3A1%3A1007", 
"startTime™" : "2014-06-14T07:33:50.496+0000"™, 
"endTime™" : "2014-06-14T07:33:50.648+0000"™, 
"durationInMillis" : 152, 
"startUserId™" : "kermit", 
"startActivityId" : "starteventl", 
"engdActivityId" : "endevent1", 
"deleteReason™" : null, 
"superProcess] ee 2 
"vatriables" : 
.// 省 刻 了 变量 部 分 的 输出 
下 
"total™ : 1, 
SS 
"sort" : "processInstanceId"， 
"order™" : "asc"™, 
"size" : 1 


20.6 ”集成 流程 图 跟踪 组 件 Diagram Viewer 


通过 13.3 节 介绍 的 图 片 方式 流程 跟踪 ， 可 以 直观 地 查看 当前 流程 所 处 的 节点 (使 用 Javascript 及 CSS 技 术 创建 红色 边框 标示 出 来 ) ， 这 种 方式 依赖 Activiti Designer 自 动 生成 的 流程 图 。 如 果 部 署 的 流程 
没有 提供 对 应 的 流程 图 (例如 使 用 Activiti Modeler 或 自己 开发 的 流程 设计 器 ) ， 为 了 实现 图 片 式 流程 跟踪 可 以 使 用 Activiti 官 方 提供 的 Diagram Viewer 组 件 ， 该 组 件 基于 Javascript 组 件 库 Rapha | (一 个 使 
用 SVG、VML 的 2D 画 图 组 件 ， 兼 容 所 有 浏览 器 ， 其 官网 为 : http://raphaeljs.com) 实现 。 


20.6.1 ”准备 资源 文件 


Diagram Viewer 组 件 被 集成 在 Activiti Explorer 中 ， 解 压 activiti-explorer.war 后 的 diagram-viewer 目 录 结 构 如 图 20-7 所 示 。 


mm activiti=explorer 
| activiti-explorer.war 


| activiti-rest.war 


i i 


向 | libs | | api images 
大 META-INF mm diagram-Vviewer 和 js 

六 VAADIN 和 启 | editor 全 index.html 
国 WEB-INF : explorer 男 style.css 


图 20-7 activiti-exploretr 中 集成 的 Diagram Viewet 组 件 的 目录 结构 


将 图 20-7 中 的 diagram-viewer 目 录 复制 到 chapter20-rest/src/main/webapp 目 录 中 。 


20.6.2 ”准备 配置 文件 


Diagram Viewer 组 件 采用 异步 的 方式 (Ajax) 请 求 REST 模 块 提供 的 流程 数据 来 展示 流程 图 。 这 种 方式 需要 REST 模 块 提供 流程 中 的 各 个 组 件 以 及 坐标 数据 、 流 程 实例 的 当前 节点 ， 因 此 我 们 要 为 
Diagram Viewer 组 件 配置 REST 组 件 的 服务 地 址 。 


在 pom.xml 文 件 中 添加 activiti-diagram-rest 模 块 依赖 ， 依 赖 配置 如 下 : 


<dependency> 
<groupId>org.activiti</groupId> 
<artifactId>activiti-diagram-rest</artifactId> 
<version>$ {activiti-version}</version> 
</dependency> 


在 web.xml (代码 如 下 ) 中 配置 继承 自 Restlet 的 Application 类 TraceRestApplication， 该 类 的 实现 可 以 在 Activiti 源 码 的 activiti-common-rest 模 块 中 找到 


(org.activiti.rest.explorer.application.ExplorerRestApplication) 。 


<serviet> 
<servilet-name>TraceRestletServilet</servlet-name> 
<serviet-class> 
org.restlet .ext.servlet.ServerServlet 
</servilet-class> 
<init-param> 
<!-—- Application class name 一 -> 
<param-name>org.restlet.application</param-name> 
<param-value> 
me.kafeitu.activiti.chapter20.rest 
.application.TraceRestApplication 
</param-value> 
</init-param> 
</servilet> 
<serviet-mapping> 
<servilet-name>TraceRestletServilet</servlet-name> 
<url-pattern>/trace/*</url-pattern> 
</servilet-mapping> 


我 们 把 这 部 分 源码 复制 过 来 并 将 其 改名 为 TraceRestApplication， 见 代码 清单 20-17 所 示 。 


代码 清单 20-17 ”Diagram Viewer 组 件 的 服务 入 口 


package me.kafeitu.activiti.chapter20.rest.application; 

public class TraceRestApplication extends ActivitiRestApplication { 
public TraceRestApplication() { 

super (); 

} 
QOverride 
public synchronized Restlet createInboundRoot() { 
Router router = new Router (getContext ()); 
DiagramServicesInit.attachResources (router); // 添加 创建 流程 图 REST 服 务 
// 用 jsonp 包 装 以 支持 JSONP 调 用 
JsonpFilter jsonpFilter = new JsonpFilter (getContext ()); 
jsonpFilter.setNext (router); 
return jsonpFilter; 


} 


20.6.3 ”访问 Diagram Viewer 跟 踪 流 程 


为 了 配合 演示 如 何 使 用 Diagram Viewer， 我 们 创建 了 一 个 测试 辅助 类 RestRequestFor-DiagramViewer 用 来 启动 一 个 请 假 流 程 ， 见 代码 清单 20-18 所 示 。 


代码 清单 20-18 RestRequestForDiagramViewer.java 


public class RestRequestForDiagramViewer { 
private static final String BASE REST UR 
"http: Wi 8080/chapter20-rest/service/"; 
private static ObjectMapper objectMapper = new ObjectMapper (); 
private static boolean formateOutputJson = true; 
public static void main(String[] args) throws IOException { 
// 部 署 流 程 
deployLeave ();}; 
// 查询 deployment 
queryDeployment () ， 
// 查询 请 假 流 程 的 最 新 版 本 ID 
JsonNode jsonNode = queryLastVersionOfLeaveProcess () ， 
ArrayNode data = (ArrayNode) jsonNode.get ("data"); 
UsonNode next = data.iterator() .next (); 
String latestVersionId = next.get ("id") .asText () ， 
System.out .println ("latestVersionId=" + latestVersionId); 
// 获取 流程 的 启动 表单 属性 
queryProcessStartForm(latestVersionId); 
// 启动 流程 
jsonNode = StartProcessInstance (latestVersionId); 
String ProcessInstanceId = jsonNode.get ("id") .asText () ， 
System.out .println ("启动 了 流程 : " + ProcessInstanceId) ; 


} 
// 以 上 方法 的 实现 代码 参见 20 .5 节 


启动 chapter20-rest 项 目 后 ， 打 开 终 端 命 令 行 ， 执 行 命令 mvn antrun:run-Pinit-db 初 始 化 用 户 数据 ， 然 后 运行 代码 清单 20-18 的 示例 代码 ， 执 行 后 成 功 启 动 了 一 个 流程 实例 ， 输 出 结果 如 下 : 


=== 启动 请 假 流程 一 = 
{ 
1 Ta 。 ow 5 1 
"url" : "http://localhost:8080/chapter20-rest/service/runtime/process-instances/5", 
"businessKey" : null, 
"suspended" : false, 
"processDefinitionId" : "leave:1:4", 
"processDefinitionUrl" : "http://localhost:8080/chapter20-rest/service/repository/process-definitions/leave%3A1%3A4", 
"activityld" : "deptLeaderAudit", 
"variables™" : [ ]， 
"tenantId™ :; "" 


观察 上 面 的 输出 结果 可 以 看 出 : 成 功 启动 了 一 个 ID 为 5 的 流程 实例 ， 关 联 的 流程 定义 ID 为 “leave:1:4”。 结 合流 程 图 可 以 知道 流程 实例 的 当前 节点 应 该 是 “部 门 领导 审批 ”， 现 在 可 以 在 浏览 器 中 访问 
Diagram Viewer 组 件 来 查看 流程 跟踪 图 了 。 


在 通过 Diagram Viewer 组 件 查看 流程 图 之 前 先 要 更 改 一 下 该 组 件 所 需 Rest 服 务 的 地 址 ， 打 开 diagrame-vieweVindex.html 文 件 ， 找 到 “ActivitiRest.options” 代 码 片段 处 ， 相 关 代码 如 下 : 


ActivitiRest.options = { 
processInstanceHighLightsUrl: lbaseUrl + 
"/service/process-instance/ {processInstancelId} 
/highlights?callback=?", 


processDefinitionUrl: baseUrl + 
"/service/process-definition/{processDefinitionId} 
/diagram-layout?callback=?", 
processDefinitionByKeyUrl: baseUrl + 
"/service/process-definition/{processDefinitionKey} 
/diagram-layout?callback=?" 


把 以 上 代码 片段 中 的 “service” 更 改 为 本 章 示例 代码 Web.xm| 文 件 中 映射 路 径 为 “trace” 的 Servlet， 然 后 在 浏览 器 中 打开 链接 http://localhost:8080/chapter20-rest/diagram-viewer/index.html? 
processDefinitionld=leave:1:4&processlnstanceld=5， 展 示 效 果 如 图 20-8 所 示 。 


localhost:8080 /chapter20-rest/diagram-viewer/index.html?processDefinitionld=|leave:1:4&processInstanceld=5 


ctivityLId: deptLeaderAudlt 
mame: 部 门 领导 审批 
type: userTask 


图 20-8 ”访问 Diagram Viewer 跟 踪 流 程 


在 图 20-8 中 可 以 看 出 ，“ 部 门 领导 审批 ”任务 由 红色 边框 显示 (由 于 黑白 印刷 ， 颜 色 不 显示 ) ， 当 鼠标 浮动 到 每 一 个 任务 上 时 ， 右 侧 都 会 展示 该 任务 的 一 些 属性 。 由 于 Diagram Viewer 完 全 基于 
Javascript 实 现 ， 因 此 可 以 根据 自己 公司 的 实际 需求 在 Diagram Viewer 的 基础 上 改造 扩展 功能 。 


20.7 ”基于 REST 服 务 搭建 流程 中 心 


在 Activiti 官 网 首页 中 有 “Activiti BPM Platform” 这 样 的 宣传 语 ， 这 很 明确 地 表述 了 Activiti 不 仅仅 是 一 个 流程 引擎 ， 还 是 一 个 BPM 平 台 ， 提 供 的 Activiti Rest 模 块 也 恰好 为 BPM 平 台 提 供 服务 ， 因 此 可 
以 把 Activiti 作 为 BPM 平 台 的 基础 ， 使 实施 者 可 以 很 轻松 地 发 布 跨 平台 、 跨 语言 的 统一 服务 接口 。 


流程 中 心 是 很 多 中 大 型 公司 不 可 缺少 的 一 个 公共 服务 。 随 着 公司 规模 不 断 扩大 ， 对 业务 系统 数量 的 需求 也 随 之 增加 ， 为 了 实现 对 各 个 业务 系统 的 统一 管理 ， 对 各 个 系统 的 流程 使 用 统一 规范 ， 流 程 中 心 
理所当然 成 为 必 备 的 服务 。 


在 本 节 笔者 根据 一 些 经 验 简单 地 谈 谈 流程 中 心 的 一 些 架 构 以 及 实施 办 法 ， 希 望 对 读者 有 些 帮 助 。 
20.7.1 ”基础 架构 


图 20-9 展 示 了 一 张 简单 的 架构 图 ， 描 述 了 业务 系统 与 流程 中 心 的 基础 架构 与 交互 过 程 。 


Nginx 负 载 均衡 : 


图 20-9 ”基础 架构 图 


图 20-9 使 用 的 是 单一 数据 库 架 构 ， 随 着 业务 系统 的 增多 ， 当 单一 数据 库 不 能 满足 需求 时 ， 可 以 考虑 根据 业务 系统 分 割 数据 库 ， 也 就 是 每 一 个 业务 系统 拥有 一 套 Activiti 引 擎 数据 库 ， 并 根据 数据 库 实例 的 
数量 创建 多 个 引擎 对 象 ， 在 每 一 个 引擎 对 象 中 配置 数据 库 的 别名 来 标示 数据 库 的 名 称 ， 这 样 就 可 以 实现 一 个 引擎 管理 多 套数 据 库 。 关 于 数据 库 别 名 的 配置 如 下 : 


figuration"™ 
EngineConfiguration"> 
Fix" value="DB 1" /> 


<bean id="processEngineCon 
class="org.activiti .xxx.Process] 
<property name="databaseTablePret 


</bean> 


20.7.2 ”表单 模式 选 型 
经 综合 考虑 笔者 认为 选择 “外 置 表单 ”的 模式 最 佳 ， 但 是 与 本 书 第 6 章 介绍 的 外 置 表单 使 用 方式 有 些 不 同 ， 虽 然 各 


流程 中 心 的 一 大 特点 就 是 “通用 ”， 所 以 选择 表单 模式 时 要 选择 支持 不 同 的 业务 系统 。 
个 业务 系统 的 开发 人 员 在 设计 流程 时 仍然 使 用 “activiti:formKey” 属 性 配置 每 个 流程 中 与 任务 关联 的 表单 ， 但 是 设置 的 值 不 是 表单 文件 的 名 称 (xxx.form) ， 而 是 一 个 相对 地 址 的 URL (每 个 接 入 系统 的 基 


础 URL 可 以 保存 在 流程 中 心 的 数据 库 表 中 ) ， 而 由 “activiti:formKey” 属 性 配置 除 基础 URL 之 外 的 相对 路 径 ， 这 样 各 个 业务 系统 在 通过 REST 接 口 获 取 任 务 表单 属性 后 就 可 以 从 当前 业务 系统 中 获取 表单 内 


容 。 20- 1 0 展示 了 一 个 大 概 的 表单 交互 过 程 。 


一 
Bn 


发 送 获取 任 
务 表单 请 求 


任务 表单 服务 接口 ( 获取 任务 的 表单 URL 后 跳 转 至 业务 系统 的 
表单 扎实 他 辑 处 理 器 ) 3 


跳 转 时 附带 一 些 和 


转 时 | 展示 层 框架 Spring 
流程 有 关 的 数据 对 象 


MYC Struts... 


业务 系统 的 表单 处 理 需 


图 20-10 ”流程 中 心 处 理 业 务 系统 表单 的 过 程 
20.7.3 ”统一 的 组 件 


除了 和 流程 引擎 使 用 统一 的 REST 服 务 之 外 ， 流 程 中 心 还 提供 一 些 通用 的 组 件 ， 例 如 20.6 节 介绍 的 流程 图 跟踪 组 件 Diagram Viewer。 如 果 有 统一 的 UI 组 件 ， 还 可 以 封装 一 些 通用 功能 ， 例 如 通用 的 按钮 
动作 处 理 : 提交 、 转 办 、 委 派 ， 或 者 批注 、 事 件 等 。 


对 于 查询 待 办 任务 、 运 行 中 流程 、 已 结束 流程 等 数据 ， 这 种 通用 的 操作 应 该 由 流程 中 心 提 供 ， 业 务 系统 只 需要 关心 业务 逻辑 ， 可 以 考虑 把 所 有 业务 系统 的 流程 数据 在 一 个 系统 中 展示 (例如 Portal 系 
统 ) ， 也 可 以 在 每 一 个 业务 系统 中 嵌入 由 流程 中 心 封装 过 的 流程 数据 查询 模块 。 


由 于 业务 数据 与 流程 数据 分 离 ， 当 查询 用 户 的 待 办 任务 时 会 遇 到 | 数据 难以 过 滤 的 问题 ， 因 为 流程 中 没有 保存 业务 数据 ， 如 果 待 办 任务 较 多 ， 用 户 会 对 这 些 待 办 任务 无 从 下 手 ， 所 以 笔者 在 设计 流程 中 心 
时 加 入 了 对 待 办 任务 查询 的 可 配置 功能 。 


在 启动 流程 或 任务 中 更 新 了 业务 数据 后 用 变量 的 方式 把 业务 字段 记录 到 引擎 表 ， 然 后 再 为 每 一 个 流程 配置 可 用 的 查询 字段 ， 在 待 办 任务 列表 中 选择 不 同 的 流程 切换 相关 的 业务 查询 字段 ， 这 样 用 户 就 可 
以 切换 不 同 流程 的 待 办 任务 且 可 以 使 用 业务 数据 过 滤 结 果 。 


20.7.4 ”事务 管理 


第 7 章 介绍 的 Spring 代 理 流程 引擎 ， 它 的 一 个 最 大 好 处 在 于 可 以 由 Spring 统 一 管理 Activiti 引 擎 与 业务 系统 的 事务 。 而 REST 服 务 是 独立 运行 的 ， 为 了 实现 统一 的 事务 管理 可 以 选择 使 用 分 布 式 事务 管理 ， 
不 过 这 个 方案 在 企业 内 部 用 得 不 多 。 笔 者 倾向 于 选择 另外 一 种 稍 “ 弱 ”的 通用 事务 管理 方式 ， 由 业务 方 判断 REST 服 务 的 状态 码 决定 业务 系统 事务 的 “提交 ”与 “ 回 滚 ”， 例 如 ， 局 动 流程 成 功 后 REST 服 务 返 
回 的 状态 码 为 “201”， 启 动 失败 后 返回 的 是 “400” 。 


首先 业务 系统 把 用 户 填写 的 表单 数据 保存 (此 时 事务 部 提交 ， 保 持 开启 状态 ) ， 然 后 请 求 REST 服 务 根 据 返 回 的 状态 码 与 JSON 数 据 判断 流程 中 心 是 否 正确 处 理 了 请 求 ， 如 果 处 理 成 功 ， 则 提交 业务 系统 
的 事务 ， 否 则 执行 回 滚动 作 。 


20.8 “集成 流程 设计 器 Activiti Modeler 


在 3.2 节 中 介绍 了 如 何在 Activiti Explorer 中 使 用 Activiti Modeler 流 程 设计 器 ， 由 于 Activiti Modeler 依 赖 REST 服 务 模块 ， 故 本 节 将 介绍 如 何 集成 Activiti Modeler 组 件 。 
集成 Modeler 与 集成 Diagram Viewer 的 步骤 类 似 ， 不 过 步骤 略 显 复杂 (笔者 也 希望 以 后 官方 能 够 简化 集成 的 步骤 ， 因 为 Modeler 相 关 的 文件 过 于 分 散 ) 。 


Activiti Modeler 涉 及 一 个 概念 一 一 模型 (Model) ， 模 型 也 是 Activiti Modeler 流 程 设计 器 的 产物 ， 并 且 模 型 与 流程 定义 (Process Definition) 两 者 可 以 互相 转换 ， 大 致 的 转换 过 程 可 以 参考 图 20- 


20.8.1 ”准备 资源 文件 


图 20-11 Activiti Modelet 的 模型 与 流程 定义 的 转换 过 程 


解压 Activiti 官 方 提供 的 activiti-explorer.war 后 可 以 看 到 如 图 20-12 所 示 的 目录 结构 ， 图 20-13 则 展示 了 classes 目 录 的 结构 。 


ma activitIi-explorer 

| |] activiti-explorer.war 
而 activiti-rest 

| activiti-rest.war 


api 
大 diagram-viewer 
二 | editor 


| explorer 


libs 


居 META-INF 
恒 VAADIN 
国 WEB-INF 


了 


国 api 


唱 diagram=viewer 


和 | editor 
误 | explorer 


| libs 


| META-INF 
启 | YAADIN 
户 | WEB-INF 


图 20-12 activiti-explotet 的 目录 结构 


男 activiti-stan...context.xml 
activiti-ui-context.xml 
applicationContext.xml 
em classes 

天 iib 

web.xml 


图 20-13 ”activiti-explorer 的 classes 目 录 结 构 


加 


lc 


[LaLa 


TY TT TY TY VT ¥ YY 


db.properties 
editor.html 
log4j.properties 

org 

plugins.xml 

rebel.xml 
stencilset.json 
Ui.properties 
Ui.properties.alfresco 


把 图 20-12 中 所 示 的 api、editor、explorer、libs 目 录 复制 到 本 章 示例 项 目的 chapter20-rest/src/main/webapp 目 录 中 ， 然 后 把 图 20-13 中 所 示 的 editor.html、stencilsetjson、plugins.xml 复 制 到 
chapter20-rest/src/main/resources 目 录 中 ， 最 终 的 目录 结构 如 图 20-14 所 示 。 


v Cchapter20-rest 
vv Dsrc 
vv main 
» [java 
vv [resources 
上 data 
p- diagrams 
Fa activiti-context.xml 
li db.properties 
editor.html 
[| log4j.properties 
plugins.xml 
ti stencilset.json 
v 的 webapp 
”api 
站 common 
diagram-viewer 
editor 
explorer 
0 libs 
站 static 
站 WEB-INF 


Ey index.jsp 


Bd 


vv vv vv 


图 20-14 复制 了 Activiti Modelet 相 关 文 件 后 的 目录 结构 


20.8.2 ”准备 配置 文件 


资源 文件 复制 好 后 需要 配置 Activiti Modeler 访 问 的 REST 服 务 路 由 ， 与 配置 Diagram Viewer 的 REST 服 务 类 似 ， 在 web.xml 中 添加 Modeler 模 块 的 REST 路 由 配置 ， 相 关 配 置 代 码 如 下 : 


<!-- Modeler REST 服 务 --> 
<serviet> 
<servlet-name>ModelerRestApplication </servlet-name> 
<servilet-class>org.restlet.ext.serviet.ServerServilet</servlet-class> 
<init-param> 
<!-—- Application class name 一 -> 
<param-name>org.restlet.application </param-name> 
<param-value> 
org.activiti.rest.editor.application.ModelerRestApplication 
</param-value> 
</init-param> 
</servlet> 
<serviet-mapping> 
<servlet-name>ModelerRestApplication</servlet-name> 
<url-pattern>/mservice/*</url-pattern> 
</servilet-mapping> 


以 上 配置 中 的 ModelerRestApplication 类 被 映射 到 路 径 “/mservice/*” 上 (表示 Modeler Service) ， 该 路 由 类 位 于 activiti-modeler 模 块 中 ， 所 以 还 需要 在 pom.xml 中 添加 相关 的 依赖 配置 (或 者 jar 
包 ) ， 依 赖 配置 如 下 : 


<dependency> 
<groupId>org.activiti</groupId> 
<artifactId>activiti-modeler</artifactId> 
<version>${activiti-version}</version> 
</dependency> 


20.8.3 ”更 改 默认 配置 


由 于 Activiti Modeler 的 一 些 资源 文件 从 Activiti Explorer 中 复制 而 来 ， 所 以 有 关 REST 服 务 的 配置 需要 做 一 些 调整 。 


编辑 文件 chapter20-rest/src/main/webapp/editor/oryx.debug.js， 蔡 换 其 中 的 “/service/” 为 “/mservice/”， 从 图 20-15 中 的 搜索 结构 可 以 清晰 地 看 出 和 mservice 相 关 的 配置 更 改 。 


下 chapter20-rest/src/main/webapp /editor 
VT [oryx.debug.js (7 occurrences) 
ORYX.CONFIG.SERVER HANDLER ROOT = ../mservice 


Ww Ajax.Request( ../mservice/editor/stencilset , | 


modelUrl = ../mservice/modelf + modelld + /json 

WwW Ajax.Request( ../mservice/modelfl + modelMeta.modelld + /json ,1 
saveUri= ../mservice/modelf 二 params.id + /Save 
saveUri = ../mservice/model/new 


图 20-15 oryx.debug.js 文 件 中 需要 被 蔡 换 的 相关 代码 


20.8.4 创建 模型 


创建 模型 也 就 是 调用 引擎 的 API 创 建 一 个 Model 对 象 。 可 以 查看 引 警 的 API 文 档 RepositoryService 接 口中 有 关 ModeI 的 一 些 方法 ， 如 图 20-16 所 示 。 


mewModel( ) 
Creates a new model. 


saveModel(Model model) 
Saves the model. 


图 20-16 ”RepositoryService 中 有 关 模 型 的 API 


图 20-17 展 示 了 通过 用 户 界 面 创建 模型 对 象 ， 在 输入 三 个 参数 后 单 击 “ 创 建 ”按钮 即 可 创建 一 个 模型 ， 随 即 打开 如 图 20-18 所 示 的 编辑 模型 界面 ， 从 左 侧 “ 组 件 库 ”中 拖 动 组 件 设计 好 流程 ， 然 后 单 击 图 
20-18 中 左上 角 的 保存 按钮 ， 打 开 如 图 20-19 所 示 的 模型 列表 页 面 即 可 看 到 已 经 保存 的 模型 。 


IOO0 nlchapterz0 x WV VV : ee 
€ 3 CO localhost:8080/chapter20-rest/chapter20/model/list 


创建 新 模型 


请 假 流 程 
lBave 


OA 系统 中 的 请 假 流程 


图 20-17 创建 新 模型 对 话 框 


€ 3 CD localhostB080/chapter20-rest/mservice/editor?id=801 


Gy Activiti Modeler 
因 ! 才 中 全 X13E'! 村 名 ss 1! 让 让 1! 全 全 国 国 


Shape Repository 


避 A 系 纺 中 的 请 肯 流 得 
Li 
Yes 


"iotaCount"0, “hems 


] 
重新 申请 A 


Exclusive Gatewey 


oe 属性 设置 区 域 


图 20-18 ”编辑 模型 界面 


cc 中 localhost:8080/chapter20-rest/chapter20/model/list 
创建 新 模型 


版 
ID KEY 名称 本 创建 时 间 最 后 更 新 时 间 元 数据 操作 


801 leave leave.bpmn 1 SatJun 28 Sat Jun 28 ("name":" 请 假 流 编辑 部 署 
17:56:59 CST 17:56:59 GST 程 ","revision”:1,"description”:“OA 系 统 导出 删除 
2014 2014 中 的 请 假 流 程 "} 


共 1 和 条 << < 上 >> 


图 20-19 ”模型 列表 


图 20-17、 图 20-18 和 图 20-19 的 相关 代码 可 以 在 本 章 示例 代 码 的 src/main/java/me/kafeitu/activiti/web/chapter20/ModelControllerjava 以 及 src/main/webapp/WEB- 
INF/views/chapter20/model-list.jsp 中 找到 ， 其 中 ModelerController 的 映射 路 径 为 “/chapter20/model”。 


图 20-17 的 创建 新 模型 的 代码 见 代 码 清单 20-19。 


代码 清单 20-19 ”创建 新 模型 的 实现 代码 


QRequestMapping (value = "create") 

public void create (GRequestParam("name") String name, // 模型 名 称 
QRequestParam("key") String key，// 模型 KEY 

QRequestParam(value = "description", required = false) String description, 

HttpServietRequest request, HttpServiletResponse response) { 


try { 
ObjectMapper objectMapper = new ObjectMapper () ， 
ObjectNode modelObjectNode = objectMapper .createObjectNode () ， #1-S 
modelObjectNode.put (ModelDataJsonConstants .MODEL NAME, name); 
modelObjectNode .put (ModelDataJsonConstants .MODEL | REVISION, 1); 
modelObjectNode.put (ModelDataJsonConstants 
.MODEL DESCRIPTION, StringUtils.defaultString description)) #1-E 
Model newModel = repositoryService.newModel (); // 创建 模型 对 象 #2 
newModel .setMetaInfo (modelObjectNode.tosString()); #3-S 
newModel .setName (name); 
newModel .setKey (StringUtils.defaultString (key) ); repositoryService.saveModel (newModel); ”// 保存 模型 对 象 #3 一 
ObjectNode editorNode = objectMapper.createObjectNode () ， #4-S 


editorNode.put ("id", "canvas"); 

editorNode.put ("resourcelId", "canvas"); 

ObjectNode stencilSetNode = objectMapper.createObjectNode () ， 

stencilSetNode.put ("namespace", "http://b3mn.org/stencilset/bpmn2.0#"); 

editorNode.put ("stencilset", stencilSetNode); 

// 为 模型 绑 定 参数 

repositoryService.addModelEditorSource (newModel .getId(), #4 一 ] 
edqjitorNode .toString () .getBytes ("utf-8")); 

// 打开 模型 设计 界面 


response.sendRedirect (redquest .getContextPath () 十 #5 
"/mservice/editor?id=" + newModel .getId()); 
} catch (Exception e) 1{ 
logger .error (" 创 建 模 型 失败 : " 


| 


} 


在 代码 清单 20-19 的 #2 处 创建 一 个 新 的 模型 对 象 ， 在 #3 处 将 #1 处 定义 的 模型 的 元 信息 (Meta Info) 设置 到 新 模型 对 象 中 并 保存 新 模型 对 象 到 引 警 数据库 ( 表 ACT_RE_MODEL) ， 在 #4 处 为 新 模型 设 
置 设计 器 相关 属性 (以 二 进 制 的 方式 保存 在 ACT_GE_BYTEARRAY 表 中 ， 通 过 字段 EDITOR_SOURCE_VALUE_ID 字 段 关 联 ， 数 据 为 JSON 格 式 ) ， 最 后 在 #5 处 把 相应 结果 重 定向 到 activiti-modeler 模 块 的 模 
型 设计 界面 服务 ， 展 示 如 图 20-18 所 示 的 模型 编辑 界面 。 


20.8.5 ”导出 模型 的 流程 XML 


单 击 图 20-19 中 的 “导出 ”链接 即 可 下 载 一 个 XML 格 式 的 文件 。 该 文件 是 一 个 标准 的 流程 文件 ， 导 出 的 文件 内 容 如 图 20-20 所 示 ， 相 关 代 码 见 代 码 清单 20-20 所 示 。 


€ re Cc bh file: REED s /ee Bema xml 


This XML file does not appear to have any style information associated with it. The document tree is shown below. 


T<daefinitions xmlna=" "http /ww .omg.org/apec/BEMN/20100524/MODEL" xmlna!:xsis"httpi/ /ww .wi.o0rg/2001 /XMLSchema=instAance” 
xmlns:xsd="http: /waew. wa. org/2001/xXMLSchema" xmlns:activiti="http:i /activiti.org/bpmn" xmlns:bpemndia="http:/ /Www omg org/speci 
xmlnstomgde="http:/ /ww.omg.org/spee/DD/20100524/DC" xmlnatomgdis"http:/ /ww .omg.org/spee/DD/20100524/DI" typeLanguage="http: 
expressiconLanguage= "httpi/ /ww wa.org/l1999/ XPath"” targetNamespace=" "http!/ /ww .kafeityu.me/activiti/leave"> 
T<process id="leave” name=" 博 假 流程 " isExecutable="true"> 

T<BtartEvent id="starteventl" name="Start"” activitiinitiators"applyUserld"> 
TaxrtensiconElements> 
<activitisformProperty id="startDate"” name=" 请 假 开 始 日 期 "type="date" required="true"/> 
<activitisformproperty id="endDate"” nama=s" 请 假 结束 目 期 ” type="date"” required="true"/> 
有 tivitiformProperty id="reason” name=" 人 请假 原因 " type="string” reguired="true" /> 
/exteaenaionElements> 
/atartEvent> 
T<userTask id="deptLeaderAudit" name=" 部 门 领导 审批 "ectivitiscandidateGroups="deptLeader"> 
TeaxtensionElements> 
<activitisformproperty id="startDate” name=" 请 假 开 始 日 期 "type="date”" writable="falae"/> 


图 20-20 ”从 模型 中 导出 的 流程 文件 内 容 


代码 清单 20-20 ”从 模型 对 象 中 导出 流程 文件 


@QRequestMapping (value = "export/ {modelId}") 

public void export (GQPathVariable ("modelld") String modelId, HttpServletResponse response) { 
try { 

Model modelData = repositoryService.getModel (modelIgd); // 获取 模型 对 象 

BpmnJsonConverter jsonConverter = new BpmnJsonConverter () ， 

JsonNode editorNode = new 0bjectMapper() // 从 模型 对 象 中 读 取 JSON 数 据 
.readTree (repositoryService.getModelFEditorSource (modelData.getId())); 
// 把 JSON 对 和 象 转换 为 BpmnModel 

BpmnModel bpmnModel = jsonConverter.convertToBpmnModel (editorNode); 

BpmnXMLConverter xmlConverter = new BpmXMLConverter (); 

// 把 1 es 

byte [] bpmn = xmlConverter.convertToXML (bpmnModel); 

7/ 站 于 向 入 流 罩 出 文件 六 容 汉 油 攻 

ByteArray] [nputStream in = new ByteArrayInputStream (bpmnBytes) ， 

IOUtils.copy (in, response. getOoutputSstream() ); 
String filename = bpmnModel .detMainProcess () .getId() + ".bpmn20.xml"; 
response.setHeader ("Content-Disposition", "attachment; filename=" + filename); 
response.flushBuf 0 

} catch (Exception e) 
logger .error ( ee modelId={}", modelId, e); 


三 > 


20.8.6 ”把 模型 转换 为 流程 定义 


单 击 图 20-19 中 的 “部 署 ” 链 接 即 可 把 模型 转换 成 流程 定义 并 部 署 到 引擎 中 ， 如 图 20-21 所 示 。 相 关 代 码 见 代 码 清单 20-21 所 示 。 


3 [| localhost:8080/chapter20-rest/chapterS /processes 


争 堵 流程 资源 


| Choose File | No file chosen 


流程 定义 ID ”部 署 ID | 流程 定义 和 名称 流程 定义 KEY 流程 描述 ”版 本 号 | XML 流程 图 状态 候选 启动 操作 
laave:1:806 803 请 假 流程 leave 查看 | 查看 正常 


图 20-21 ”把 模型 转换 成 流程 定义 后 的 流程 定义 列表 


代码 清单 20-21 ”把 模型 转换 为 流程 定义 并 部 署 


@QRequestMapping (value = "deploy/ {modelId}") 
public String deploy (GPathVariable ("modelId") String modelId, RedirectAttributes redirectAttributes) { 
try { 
Model modelData = repositoryService.getModel (modelId); #1-S 
ObjectNode modelNode = (ObjectNode) new ObjectMapper () 
.readTree (repositoryService.getModelEditorSource (modelData.getId())); 
bytel[l] bpmnBytes = null; 
BpmnModel model = new BpmnJsonConverter () .convertToBpmnModel (modelNode); 
bpmnBytes = new BpmnXMLConverter () .convertToXML (model1); # 工 一 ] 
String processName = modelData.getName() + ".bpmn20.xml"; 
Deployment deployment = repositoryService.createDeployment () #2-S 
.name (modelData.getName () ) // 流程 名 称 
.addString (processName, new String (bpmnBytes)) // 以 String 方 式 部 署 
.deploy(); // 部 署 #2 
} catch (Exception e) 1{ 
logger.error ("根据 模型 部 署 流程 失败 : modelIgd={}"，modelId,，e); 


} 
return "redirect:/chapter20/model/list"; 


} 


代码 清单 20-21 中 ，#1 处 的 代码 与 代码 清单 20-20 中 重合 ，#2 处 创建 了 Deployment 对 象 并 把 模型 的 流程 XML 字 节 转 换 为 String 类 型 部 署 到 3 引擎 
20.8.7 ”把 流程 定义 转换 为 模型 
图 20-22 描 述 了 模型 与 流程 定义 的 互 转 过 程 ， 我 们 可 以 把 某 一 个 版 本 的 流程 定义 转换 成 模型 对 象 ， 在 完成 模型 设计 后 再 部 署 到 引擎 中 ， 在 实际 应 用 中 会 经 常 以 这 种 方式 迭代 修改 流程 逻辑 . 
单 击 图 20-22 中 所 示 的 “转换 为 模型 。 选 项， 页面 跳 转 到 模型 列表 页 面 ， 从 图 20-23 中 可 以 看 出 多 出 了 一 个 模型 记录 。 相 关 的 代码 见 代码 清单 20-22 所 示 。 
流程 定义 ID ” 部署 ID 流程 定义 名 称 ”流程 定义 KEY ”流程 描述 ”版 本 号 XML 流程 图 状态 候选 启动 操作 
leave:1:806 ”803 请 假 流程 leave 查看 ”查看 正常 操作 ~ | 


和 皇 候 选 启动 
共 1 和 条 << -> >> 蝇 挂 起 


巴 转换 为 模型 


图 20-22 ”把 流程 定义 转换 为 模型 


€ GDIocalhost:8080/chapter20-rest/chapter20/modeljlist 


ID KEY 


B801 


名 称 


leave 请 假 流 程 


807 | lsave 请 假 流 
程 .bpmn20.xml 


版 
本 


创建 时 间 


Sat Jun 28 
17:56:59 GST 
2014 


Sat Jun 28 
19:17:30 GST 
2014 


最 后 更 新 时 间 


Sat Jun 28 
18:01:18 GST 
2014 


Sat Jun 28 
19:17:30 CST 
2014 


元 数据 


"name": 请假 流 


创建 新 模型 


操作 
编辑 部 署 


程 ","revision":1,"description":"OA 系 统 | 导出 删除 


中 的 请 假 流 程 ") 


("name":" 请 假 流 
程 ”" revision :1 description :nu 咱 


编辑 部 署 
导出 删除 


图 20-23 ”转换 流程 定义 为 模型 后 的 模型 列表 
代码 清单 20-22 ”把 流程 定义 转换 为 模型 
GReauestMapping (value = "/process/convert-to-model/ {processDefinitionId}") 
public String convertToModel ( 
QPathVariable ("processDefinitionId") String processDefinitionId) 
throws UnsupportedEncodingException, XMLStreamException { 
// 查询 流程 定义 
ProcessDefinition processDef finition = repositoryService.createProcessDefinitionQuery () 
processDefinitionId (ProcessDefinitionId) .singleResult () ， 
// 读 取 流入 定义 的 XI 输入 流 
InputSstream bpmnStream = repositoryService 
.getResourceAsStream (processDefinition.getDeployment1d(), 
processDefinition.getResourceName () ) ; 
XMLInputFactory xif = XMLInputFactory.newInstance () ， #1-S 
InputStreamReader in = new InputStreamReader (bpmnStream, "UTF-8"); 
XMLStreamReader xtr = xif.createXMLStreamReader (in); 
BpmnModel bpmnModel = new BpmnXMLConverter () .convertToBpmnModel (xtr); 
BpmnJsonConverter converter = new BpmnJsonConverter () ， 
ObjectNode modelNode = converter.convertToJson (bpmnModel); 
Model modelData = repositoryService.newModel (); #1-1] 
modelData.setKey (processDefinition.getKey()); 
modelData.setName (processDefinition.getResourceName () );，; 
modelData.setCategory (processDefinition.getDeployment1d()); 
ObjectNode modelObjectNode = new ObjectMapper () .createObjectNode (); 
modelObjectNode .put (ModelDataJsonConstants .MODEL NAME, 
processDefinition.getName () ) ， 
modelObjectNode.put (ModelDataJsonConstants .MODEL REVISION, 1); 
modelObjectNode.put (ModelDataJsonConstants .MODEL DESCRIPTION, 
processDef Finition.getDescription ()); 
modelData.setMetaInfo (modelObjectNode.toString ()); #1-—E 
// 保存 模 型 并 设置 模型 的 届 性 
repositoryService.saveModel (modelData); 
repositoryService.addModelEditorSource (modelData.getId(), modelNode.toString() .getBytes ("utf-8")); 
return "redirect:/chapter20/model/list"; 


代码 清单 20-22 综 合 了 本 节 已 经 涉及 的 功能 ，#1 处 设置 了 一 些 模 型 的 属性 并 在 #1-1 处 创建 一 个 新 的 模型 


20.8.8 删除 模型 


单 击 图 20-19 中 所 示 的 “删除 ”链接 可 以 删除 一 个 模型 记录 ， 相 关 代 码 见 代码 清单 20-23 所 示 。 


代码 清单 20-23 ”删除 模型 


后 保存 模型 对 象 ， 过 


旦 综合 了 模型 导出 XML 和 创建 新 模型 。 


QRequestMapping (value = "delete/ {modelI 
public String delete (GPathVariabl 


repositoryService.deleteMode] 


e ("modelId") 
(mode] 


d}") 


Td); 


return "redirect:/chapt 


ter20/model/l 


Lot 


String modelId) { 


20.9 ”本 章 小 结 


本 章 详细 介 
一 个 流程 的 生命 周期 。 


绍 了 Activiti REST 架 构 的 AP|， 


它 为 访问 引 敬 


REST API 的 最 大 目的 是 搭建 一 个 流程 中 心 (或 平台 ) ， 


了 如 何 基于 REST 搭 建 通 


前 用 的 流程 中 心 。 


第 21 草 ”入侵 Activiti 


本 章 应 该 算 高 


篇 中 最 “高 级 ”的 内 容 ， 因 为 本 章 内 容 大 多 与 Activiti3 引 | 擎 


泌 提 供 了 另外 一 种 交互 方式 ， 有 利于 分 布 式 服务 的 搭建 。 另 外 ， 还 介 


如 了 如 何 使 用 不 同 的 客户 


澳 访 问 REST APl， 


并 且 通 过 


过 一 个 完整 的 示例 展示 了 


所 以 Activiti 官 方 提 供 了 基于 B/S 架构 的 统一 的 流程 跟踪 组 件 一 一 Diagram Viewer， 以 及 流程 设计 器 一 一 Activiti Modeler， 并 从 架构 的 层面 阐述 


的 内 部 实现 有 关 的 ， 


剖析 了 一 些 技术 的 实现 原理 ， 以 及 如 何 更 改 默认 实现 或 添加 自 定义 实现 从 而 “侵入 ”到 引擎 


内 部 。 


当 默 认 


实现 不 能 满足 我 们 的 需求 时 ， 这 项 侵入 引擎 的 “技能 ”就 显得 尤为 重要 了 。 学 习 完 本 章 内 容 后 相信 强大 的 你 可 以 用 “透明 ”的 方式 看 穿 每 一 个 动作 的 执行 过 程 。 


21.1 解析 BPMN 文 件 


回顾 一 下 图 1-1 展 示 的 流程 生命 周期 图 ， 开 发 人 员 根 据 业 务 人 员 的 需求 设计 完 流程 定义 后 就 要 审查 部 署 到 引擎 验证 设计 的 流程 是 否 符合 预期 目标 ， 在 Activiti 中 “部 署 ” 动 作 总 是 排 在 第 一 步 进行 的 ， 引 
擎 会 解析 XML 格式 的 流程 文件 提取 流程 定义 (ProcessDefinition) 对 象 ， 部署 动作 由 BpmnDeployer 类 负责 图 21-1 展 示 了 该 类 依赖 的 各 种 解析 、 处 理 器 的 结构 图 。 从 图 21-1 中 可 以 看 到 很 多 种 处 理 器 ， 每 
一 种 处 理 器 下 面 还 有 具体 的 活动 解析 实现 类 。 最 终 处 理 完 成 后 会 得 到 (一 个 或 者 多 个 ) 流程 定义 对 象 ， 之 后 再 把 这 些 对 象 保存 到 引擎 数据 库 ， 同 时 也 会 把 解析 后 得 到 的 流程 定义 对 象 缓存 起 来 便于 后 续 使 
用 。 


图 21-2 展 示 了 一 个 XML 格式 的 流程 文件 如 何 经 过 几 个 大 的 步骤 部 署 到 引擎 的 过 程 。 


BpmnDeployer 
BPMN 部 署 颖 


ExpressionManager Bpmn Parser IdGenerator 
表达 式 解 析 咒 BPMN 解 析 器 ID 生成 器 


BpmnParserHandlers Wl ActivityBehaviorFactory 
Bpmn 解 析 器 处 理 器 活动 行为 工厂 类 


ExpressionManager § ListenerFactory 
表达 式 解析 器 监听 处 理 器 


TaskActivityBehavior 
UserlaskActvtyBehavior 
MailActvityBehavior 


Jueltxpression 


默认 使 用 UEL 解 析 DefaultBpmnParseHandler 


内 置 的 活动 解析 处 理 


TaskListener 
ExecutionListener PreBpmnParseHandler 
ActivitiEventListener 国 目 定义 的 解析 活动 前 处 理 器 


PostBpmnParseHandler 


目 定 义 的 解析 活动 后 


解析 处 理 器 


TaskParseHandler 
SequenceFlowParseHandler 
InclusiveGatewayParseHandler 


图 21-1 ”部署 流程 的 处 理 类 BpmnDeployer 的 依赖 图 


区 给 
BpmnDeployer 
部 着 


保存 资源 文件 
到 数据 库 


流程 实例 对 和 象 


ProcessDefinition 


持久 化 并 缓存 


ProcessDefinition 


图 21-2 ”流程 文件 部 署 到 引擎 的 大 致 过 程 


21.1.1 BpmnModel 对 象 与 XML 之 间 的 转换 


BpmnModel 对 象 是 Activiti 中 用 来 描述 在 流程 中 组 建 的 一 个 普通 Bean， 包 含 了 流程 文件 中 所 有 活动 (Activity) 的 定义 ， 打 开 该 类 的 源码 ， 从 中 可 以 看 到 下 面 的 属性 定义 


public class BpmnModel { 
// definitions 的 一 些 属性 集合 
protected Map<String, i 
definitionsAttributes = new LinkedHashMap<>( 
// 流程 文件 中 定义 的 流程 集合 < 征程 文件 种 完 册 定义 多 个 流程 ) 


protected List<Process> processes = new ArrayList<Process>(); 


2 getter and setter 
} 


在 13.3 节 中 就 已 经 介绍 过 如 何 获 取 BpmnModel 对 象 ， 然 后 根据 BpmnModel 对 象 再 生成 流程 图 。 获 取 BpmnModel 对 象 的 相关 代码 如 下 : 


BpmnModel bpmnModel] = repositoryService 
.getBpmnModel (ProcessDefinitionIad) ， 


以 上 代码 使 用 了 Activiti 的 activiti-bpmn-converter 模 块 提供 的 BgBpmnModel 对 象 与 XML 的 互 转 功能 ， 通 过 创建 ore activiti.bpmn.converter.BpmnXMILConvertet 类 对 象 调用 相应 的 方法 即 可 实现 BpmnModel 
对 象 与 XML 之 间 的 转换 操作 。 下 面 通 过 代码 清单 21-1 和 代码 清单 21-2 分 别 演示 两 者 之 间 互 相 转 换 的 AP1。 


不 过 在 学 习 之 前 要 先 在 Maven 配 置 文件 pom.xml 中 添加 如 下 的 依赖 配置 ，BpmnModel 类 位 于 模块 activiti-bpmn-model 中 ，BpmnXMLConverter 类 位 于 activiti-bpmn-converter 模 块 中 。 


<dependency> 
<groupId>org.activiti</groupId> 
<artifactId>activiti-bpmn-model</artifactId> 
<version>${activiti.version}</version> 
</dependency> 
<dependency> 
<groupId>org.activiti</groupId> 
<artifactId>activiti-bpmn-converter</artifactId> 
<version>${activiti.version}</version> 
</dependency> 


代码 清单 21-1 演 示 了 如 何 把 一 个 XML 文 件 内 容 转 换 成 BpmnModel 对 象 并 验证 转换 后 得 到 的 BpmnModel 对 象 中 是 否 包 含 了 流程 (Process) 对 象 。 
@& 示 到 底 BpmnModel 对 象 中 包含 了 哪些 属性 ， 可 以 在 IDE 中 用 Debug 断 点 查看 该 对 象 中 的 所 有 属性 ， 由 于 篇 幅 有 限 本 书 就 不 详细 介绍 了 。 


代码 清单 21-1 把 XML 内 容 转 换 成 BpmnModel 对 象 


public class BpmnModelTest extends ApstractTest { 
// 把 XML 转换 成 BpmnModel 对 象 
eTest // 测试 时 自动 部 署 流程 


QDeployment (resources = "chapter6/dynamic-form/leave.bpmn") 


public void testXmlToBpmnModel () throws Exception { 
// 根据 流程 定义 获取 XML 资源 文件 流 对 象 
ProcessDefinition processDefinition = repositoryService #1-S 
.CreateProcessDefinitionQuery () 
“processDefinitionKey ("leave") .singleResult (); 
String resourceName = processDefinition.getResourceName (); 
InputStream inputStream = repositoryService 


getResourceAsStream (processDefinition.getDeploymentId(), resourceName); #1-E 
// 创建 转换 对 象 
BpmnXMLConverter converter = new BpmXMLConverter () ; #2 
// 创建 XMLStreamReaqer 读 取 XML 资 源 


XMLInputFactory factory = XMLInputFactory.newInstance () ， 
XMLStreamReader reader = factory.createXMLStreamReader (inputStream) ， 
// 把 XML 转 换 成 BomnModel1 对 象 
BpmnModel bpmnModel = converter.convertToBpmnModel (reader); #3 
// 验证 BpmnMoqe1 对 象 不 为 空 

assertNotNull (bpmnModel); 

Process process = bpmnModel .dgetMainProcess () 

assertEquals ("leave", process.getId()); // 输 证 转换 得 到 的 流程 I 


蝇 


代码 清单 21-1 的 #1 处 从 引擎 中 读 取 流 程 定义 并 根据 XML 资 源 文件 名 称 获 取 输 入 流 对 象 ，#2 处 创建 了 一 个 BpmnXMLConverter 类 的 实例 ，#3 处 调用 convertToBpmnModel() 方 法 得 到 一 个 BpmnModel 
对 象 并 在 最 后 验证 了 该 对 象 中 是 否 包含 了 流程 (Process) 对 象 。 


其 中 #1 处 读 取 Bpmn 文 件 输入 流 也 可 以 更 改 成 从 Classpath 读 取 ， 代 码 如 下 : 


InputStream inputStream = getClass () .getClassLoader () 
.getResourceAsStream("chapter6/dynamic-form/leave.bpmn"); 


与 代码 清单 21-1 相 反 ， 代 码 清单 21-2 展 示 了 如 何 把 BpmnModel 对 象 转换 成 XML 格式 的 字符 串 。 


代码 清单 21-2 ”把 BpmnModel 对 象 转换 成 XML 内 容 


public class BpmnModelTest extends ApstractTest { 
@Test 
QDeployment (resources = "chapter6/dynamic-form/leave.bpmn") 


public void testBpmnModelToXxml () throws Exception { 
// 查询 流程 定义 对 象 
ProcessDefinition processDefinition = repositoryService 
.CreateProcessDefinitionQuery () 
.processDefinitionKey ("leave") .singleResult () ， 
// 获取 BpmnModel 对 象 
BpmnModel bpmnModel] = repositoryService 
.getBpmnModel (processDefinition.getlId()); 
// 创建 转换 对 象 


BpmnXMLConverter converter = new ] XMLConverter () ， 
// 把 BpmnMode1 对 象 转 换 成 字符 < 也 汪 以 辅 出 到 文件 中 
byte [] bytes = converter.convertToXML (bpmnModel); 
String xmlContent = new String (bytes); 

System.out .Println(xmnlLContent) ， 


执行 完 代码 清单 21-2 后 ， 在 控制 台 可 以 看 到 的 输出 内 容 如 图 21-3 所 示 。 


11:20:06,947 [main)] DEBUG org.activiti.engine. impL. interceptor.LogInterceptor 

<?xml Verslon= 1.0” encoding= UTF-8 

<definitions xmlns="http://www.omg.org/spec/BPMN/20100524/MODEL"™" xmlns:xsi="http://v 
<process id="Leave" name=" 请 假 流 程 - 动 态 表 单 " isExecutable="true"> 


<documentation> 请 假 流 程 演示 -动态 表单 </documentation> 
<startEvent 1d=" startevent1 ”name= ' Start” activiti:initiator="applyUserld"> 
<extensionE Lements> 
<activiti: formProperty 1 id="startDpte" name=" 请 假 开 始 日 期 "type="date" datePat 


mm | = | ED = | | I 
eT rTOFmProne De= ENdI)a name= 1 让 性 二 这 串 因 DE= a 器 司 工区 已 司 


图 21-3 ”把 BpmnModel 对 象 转 换 为 XML 内容 输出 


21.1.2 ”动态 创建 流程 


了 解 了 BpmnModel 对 象 与 XML 之 间 的 转换 ， 再 通过 一 个 有 意思 的 示例 了 解 一 下 这 个 转换 过 程 的 实际 用 途 : Activiti 团 队 成 员 “Frederik Heremans” 的 博客 中 有 一 篇 博文 ， 介 绍 的 是 如 何 动态 创建 一 个 


流程 并 ( 仅 100 行 代码 ) ， 读 者 可 以 参考 原文 《Dynamic Process Creation and Deployment in 100Lines of Code》[1]。 这 篇 博文 发 表 于 Activiti 5.12 版 本 发 布 之 前 ， 笔 者 觉得 这 能 勾 起 读者 的 兴趣 ， 所 以 
在 这 里 单独 介绍 其 运作 过 程 ， 完 整 代码 见 代码 清单 21-3 (在 原文 的 基础 之 上 做 了 一 些微 调 ) 。 


public class DynamicProcess { 
@Rule 
public ActivitiRule activitiRule = new ActivitiRule(); 
QTest 
public void testDynamicDeploy() throws Exception { 
// 1. 创建 一 个 空 的 BpmnModel 和 Process 对 象 #1 
BpmnModel model = new BpmnModel (); 
Process process = new Process () ， 
model .addProcess (process); 
process.setId ("my-process"); 
// 创建 Flow 元 素 (所 有 的 事件 、 任 务 都 被 认为 是 Flow) 
process.addFlowElement (createStartEvent ()); 
process.addFlowElement (createUserTask ("taskl", "First task", "fred")); 
process.addFlowElement (createUserTask ("task2", "Second task", "john")); 
process.addFlowElement (createEndEvent () ); 


// 创建 顺序 流 


process.addFlowElement (createSequenceFlow ("start", "task1")); 
process.addFlowElement (createSequenceFlow ("taskl", "task2")); 
process.addFlowElement (createSequenceFlow ("task2", "end")); 

// 2. 流程 图 自动 布局 (位 于 activiti-bpmm-layout 模 块 ) #2 

new BpmnAutoLayout (model) .execute (); 

// 3. 把 BpmnModel 对 象 部 署 到 引擎 #3 


Deployment deployment = activitiRule.getRepositoryService() .createDeployment () 
.addBpmnModel ("dynamic-model .bpmn", model) 
.name ("Dynamic process deployment") .deploy () ， 

// 4. 启动 流程 


ProcessInstance ProcessInstance = activitiRule.getRuntimeService () 


.StartProcessInstanceByKey ("my-process");}; 
// 5. 检查 流程 是 否 正常 启动 
List<Task> tasks = activitiRule.getTaskService() .createTaskQuery () 
.DrocessInstanceId (processInstance.get1Id()).1list(); 
// 验证 Task 
Assert.assertEquals (1, tasks.size()); 
Assert. assertEquals ("First task", tasks.get (0) .getName ()); 
Assert.assertEquals ("fred", tasks.get (0) .getAssignee()); 
// 6. 导出 流程 图 
InputStream processDiagram = activitiRule.getRepositoryService() 
getProcessDiagram (processInstance.getProcessDefinitionId()); 
// 把 文件 生成 在 本 章 项 目的 test-classes 目 录 中 
String userHomeDir = getClass () .getResource ("/") .getFile(); 
System.out.println (userHomeDir); 
FileUtils.copyInputStreamToFile (processDiagram, 
new File (userHomeDir + "/diagram.png")); 
// 7. 导出 BPMN 文 件 到 本 地 文件 系统 
InputStream processBpmn = activitiRule.getRepositoryService () 
.getResourceAsStream (deployment .getId(), "dynamic-model .bpmn"); 
FileUtils.copyInputStreamTorFile (processBpmn, 
new File (userHomeDir + "/process.bpmn20.xml")); 


} 
// 创建 用 户 任务 
protected UserTask createUserTask (String id, String name, String assignee) 1 
UserTask userTask = new UserTask (); 
userTask.setName (name); 
userTask.setlId(igd); 
userTask.setAssignee (assignee); 
return userTask; 


} 

protected SequenceFlow createSequenceFlow (String from，String to) { // 创建 顺序 流 
SequenceF low flow = new SequenceFlow(); 

flow.setSourceRef (from); 

flow.setTargetRef (to); 

return flow; 


} 

protected StartEvent createStartEvent () { // 创建 启动 事件 
StartEvent startEvent = new StartEvent () ， 
startEvent.setId("start");} 

return startEvent; 


} 
protected EndEvent createEndEvent () { // 创建 结束 事件 
EndEvent endEvent = new EndEvent (); 
endEvent.setId("end"); 

return endEvent; 


运行 完 代码 清单 21-3 中 的 类 后 在 本 章 示例 的 test-classes 目 录 中 可 以 看 到 生成 两 个 文件 : diagram.png、process.bpmn20， 如 图 21-4 所 示 。 


在 代码 清单 21-3 中 依次 创建 了 开始 事件 、 用 户 任务 以 及 连接 各 个 活动 之 间 的 顺序 流 。#2 处 的 流程 图 自动 布局 需要 特别 说 明 ， 在 #2 处 之 前 创建 的 对 象 没有 任何 坐标 信息 。 我 们 知道 要 生成 流程 图 ， 需 要 提 
供 “bpmndi:BPMNDiagram” 定 义 ， 也 就 是 每 一 个 元 素 的 XY 坐标 以 及 宽度 和 高 度 信息 。Activiti 的 activiti-bpmn-layout 就 是 专门 用 来 创建 bpmndi 信 息 的 模块 ， 该 模块 提供 的 BpmnAutoLayout 类 可 以 自动 根据 
元 素 的 类 型 计算 出 高 度 、 宽 度 及 XY 坐标 ， 然 后 设置 到 BpmnModel 对 象 的 “locationMap” 属 性 中 。 图 21-5 展 示 了 自动 生成 的 流程 图 。 
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chapter7 
chapter® 
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图 21-4 ”由 动态 创建 的 流程 生成 的 图 片 与 BPMN 文 件 


First task SeEcond task 


图 21-5 动态 创建 流程 自 动 布局 后 生成 的 流程 图 


介绍 了 这 么 多 有 关 BpmnModel 知 识 ， 可 能 会 有 人 疑惑 为 什么 要 学 习 它 ? 用 它 能 做 什么 ? 


对 此 笔者 可 以 举 个 例子 介绍 一 下 BpmnModel 的 实际 用 途 。 流 程 设计 器 是 必 不 可 少 的 工具 之 一 ， 前 面 也 介绍 了 基于 Eclipse 揪 件 的 Activiti Designer 以 及 基于 B/S 架构 的 Activiti Modeler。 如 果 企业 要 把 
一 些 常 用 组 件 封 装 成 一 个 标准 的 BPMN 2.0 规 范 的 活动 并 在 流程 中 使 用 ， 可 以 在 官方 提供 的 设计 器 基础 上 扩展 实现 ， 或 者 自己 设计 一 个 流程 设计 器 实现 ， 这 样 就 可 以 扩展 一 些 属性 或 添加 全 新 的 流程 组 件 ， 
更 有 利于 集成 企业 内 部 的 服务 组 件 。 


Activiti Modeler 的 工作 原理 是 在 前 端 使 用 SVG 技术 创建 BPMN 组 件 并 转换 成 XML， 当 用 户 保 存 Model 时 把 这 些 XML 发 送 到 后 台 保 存 。 
假设 一 个 全 新 的 流程 设计 器 是 由 Javascript 语 言 设计 的 ， 当 用 户 创建 一 个 流程 时 等 于 创建 了 一 个 新 的 gpmnModel 对 象 ， 在 用 户 拖 动 一 个 BPMN 组 件 到 工作 区 后 发 送 一 个 异步 Ajax 请 求 ， 在 后 台 创 建 一 个 
对 应 的 Process 组 件 (参考 代码 清单 21-3) 并 存放 到 Process 中 ， 以 此 类 推 ， 当 流程 设计 完成 时 就 得 到 一 个 完整 的 BbpmnModel 对 象 且 可 以 转换 成 XML 格 式 的 内 容 保 存 到 | 数据 库 以 便 下 次 存 取 。 


21.1.3” BPMN 解析 处 理 器 


一 个 开放 的 框架 或 平台 都 会 提供 与 调用 者 的 交互 接口 ， 例 如 在 Activiti 中 可 以 在 流程 上 添加 流程 的 启动 、 结 束 监听 事件 ， 也 可 以 在 任务 上 添加 任务 创建 、 分 配 人 员 、 结 束 事 件 ， 这 样 当 事 件 被 触发 时 业务 
系统 可 以 处 理 一 些 业 务 逻 辑 ， 为 开发 人 员 预 留 了 一 个 很 好 的 入 口 。 


除了 已 经 了 解 的 运行 时 监听 处 理 之 外 ，Activiti 还 支持 在 解析 BPM NN 资源 文件 时 允许 自 定义 的 BPMN 解 析 处 理 器 (BpmnParseHandler) 参与 ， 可 以 在 开始 解析 一 个 元 素 (Element) 或 解析 完 之 后 调用 
自 定义 的 BPMN 解 析 处 理 器 ， 在 自 定义 的 解析 处 理 器 中 我 们 可 以 更 改 一 些 BPMN 对 象 的 属性 。 


添加 BPM N 解 析 处 理 器 可 以 在 Activiti 引 擎 配置 文件 中 配置 属性 “preBpmnParseHandlers” 和 “postBpmnParseHandlers″”。 下 面 的 代码 针对 Pre (前 置 ) 和 Post (后 置 ) 类 型 分 别 添加 了 一 个 解析 处 


<bean id="processEngineConfiguration" class="org.activiti 
.engine.impl.cfg.XxxProcessEngineConfiguration"> 
<!1-- PRE BPMN 解 析 器 --> 
<property name="preBpmnParseHandlers"> 
<list> 
<bean class="me.kafeitu.activiti. 
chapter21 .bpmn.MyPreParseHandler" /> 


</list> 
</property> 
<!-- POST BPMN 解 析 器 --> 
<property name="postBpmnParseHandlers"> 
<list> 
<bean class="me.kafeitu.activiti. 
chapter21 .bpmn.MyPostParseHandler" /> 


</list> 
</property> 
</bean> 


在 上 面 的 代码 中 添加 了 两 种 类 型 的 BPM NN 解析 处 理 器 ， 但 是 这 两 个 解析 处 理 器 类 均 继承 自 抽象 类 org.activiti.engine.impl.bpmn.parser.handler.AbstractBpmnParseHandler， 该 抽象 类 实现 接口 
org.activiti.engine.parse.BpmnParseHandler。 之 所 以 区 分 类 型 是 为 了 更 细致 地 划分 处 理 器 的 类 型 ，Pre 类 型 的 处 理 器 总 是 排 在 第 一 位 执行 ， 也 就 是 在 所 有 流程 文件 中 定义 的 元 素 之 前 ， 而 Post 类 型 的 处 理 
器 被 放 在 最 后 执行 ， 也 就 是 在 所 有 流程 文件 中 定义 的 元 素 之 后 。 如 果 解 析 处 理 器 有 特定 的 顺序 要 求 ， 就 可 以 用 Pre 和 Post 类 型 来 区 分 。 


代码 清单 21-4 列 出 了 前 置 BPMN 解 析 处 理 器 MyPreParseHandler 的 实现 代码 。 


代码 清单 21-4 ”前 置 BPMN 解 析 处 理 器 


import org.activiti.bpmn.model .Process; 
public class MyPreParseHandler extends AbstractBpmParseHandler<Process> { #1 
protected Class< ? extends BaseElement> getHandledType() 1{ 
return Process.class; #2 


全 


} 

QOverride 

protected void executeParse (BpmnParse bpmnParse Process process) { 
process.setName (element .getName () + "- 被 PRE 解 析 器 修改 ") ; 

} 


代码 清单 21-4 中 的 类 继承 自 抽象 类 AbstractBpmnParseHandler<Process>。 注 意 泛 型 部 分 的 Process， 被 泛 型 的 类 是 Activiti 中 用 来 描述 BPMN 2.0 元 素 的 JavaBean， 这 里 的 Process 表 示 的 一 个 流 
程 。#2 处 的 getHandledType0 方 法 返回 了 一 个 Process 的 class 对 象 ， 表示 这 个 处 理 器 只 用 来 解析 Process 类 型 的 BPMN 2.0 元 素 ; 在 #3 处 对 对 象 的 Name 属 性 进行 了 更 改 ， 也 就 是 对 流程 的 名 称 属性 进行 更 改 。 


代码 清单 21-4 中 的 类 继承 了 抽象 类 ， 只 处 理 Process 这 一 种 类 型 的 元 素 。 如 果 要 在 一 个 类 中 处 理 多 个 该 如 何 实现 呢 ?” 此 时 就 需要 实现 接口 BpmnParseHandler， 查 看 抽象 类 AbstractBpmnParseHandler 源 
码 可 以 看 出 ， 该 抽象 类 继承 自 接口 BpmnParseHandler， 只 不 过 该 抽象 类 稍 加 包装 后 只 允许 处 理 一 种 类 型 的 BPM N 2.0 元 素 ; 查看 接口 BpmnParseHandler 的 源码 可 以 看 出 ，getHandledTypes() 方 法 需 
返回 一 个 Set<Class<? extends BaseElement> > 的 集合 ， 也 就 是 一 个 解析 处 理 器 可 以 注册 多 种 BPM N 2.0 元 素 ， 该 接口 的 定义 如 下 所 示 。 


public interface BpmpParseHandler { 
Collection<Class<? extends BaseElLlement>> getHandledTypes () ， 
void parse (BpmnParse bpmnParse, BaseElement element); 


为 了 演示 两 种 方法 的 不 同 ， 代 码 清 单 21-5 定 义 了 一 个 后 置 类 型 的 解析 处 理 器 ， 实 现 了 BpmnParseHandler 接 口 。 


代码 清单 21-5 ”后 置 BPMN 解 析 处 理 器 


public class MyPostParseHandler implements BpmnParseHandler ({ 
QOverride 
public Collection<Class<? extends BaseElement>> getHandledTypes() { #1-S 
Set<Class< ? extends BaseElement>> types = new HashSet<Class<? extends BaseElement>>(); 
types.add (Process.class); 
types.add (UserTask.class); 
return types; #1 一 E 


QOverride 
public void parse (BpmnParse ppmnParse，BaseElement element) { 
if (element instanceof Process) 1 #2-S 
ProcessDefinitionEntity processDefinition = 
bpmnParse .getCurrentProcessDefinition () ， 


String key = ProcessDefinition.getKey() ; 

processDefinition.setKey (key + "-modified-by-post-parse-handler"); #2-E 
} else if (element instanceof UserTask) { #3-S 

UserTask userTask = (UserTask) element; 

List<SequenceFlow> outgoingFlows = userTask.getOutgoingFlows () ， 

System.out .Println("UserTask: [" + userTask.getName () + "] 的 输出 流 : ") ; 

for (SequenceFlow outgoingFlow : outgoingFlows) { 

System.out.println("\t" + outgoingFlow.getTargetRef ()); 


} 
} #3-EE 


代码 清单 21-5 的 #1 处 返回 了 两 种 类 型 的 BPM N 2.0 元 素 对 象 ， 
以 理解 其 运作 过 程 ， 当 然 建议 读者 用 Debug 的 方式 在 Activiti 源 码 中 断 点 


代码 清单 21-6 BpmnParseHandlerTest 


public class 
public 
super.activit 


运行 完 单元 测试 后 


除了 以 上 两 种 处 理 方式 外 还 


} 


BpmnpParse 


Handl 
iRu] 


erTest () 
e 


QTest 


@Deployment (resources = "chapter6/dqynamic- 


{ 


new ActivitiRule ("activiti.da 


分 别 为 Process (流程 ) 、 


册 察 运行 过 程 。 


BpmnParseHandlerTest extends AbstractTest { 


用 户 任 务 (UserTask) 


form/leave .bpmn") 


fg .chapter21 .parse. 


xml");}; 


public void testParseHandler () throws Exception { 
ProcessDefinition processDefinition = repositoryService 
.CreateProcessDefinitionQuery() .singleResult (); 
assertEquals ("请 假 流程 -动态 表单 -被 PRE 解 析 器 修改 "， #1 
processDefinition.getName () ) ， 
assertEquals ("leave-modified-by-post-parse-handler", processDe 
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单 21-7。 
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代码 清单 21-7 CustomServiceTaskBpmnParseHandler 


public class CustomUserTasklI 
ted void executeParse ( 
tePpars 


在 代码 清单 21-6 的 基础 上 再 添加 一 些 输出 ( 见 代 码 清单 21-8) 


全 提示 自 定义 的 解析 处 理 器 只 全 


protec 


super. 


XeCu 
tyImpl 


Activi 


BpmnParseHandler extends UserTaskParseHandler { 
BpmnParse bpmnParse, UserTask userTask) { 
(bpmnParse, userTask); 


activity = 


findActivity (bpmnParse, userTask.getI 


activity.se 


tAsync (true); 


会 更 改 流程 


d()); 


代码 清单 21-8 ”用 来 验证 User Task 是 否 被 更 改 成 了 异 


@Test 
QDeployment (resources = "chapter6/dynamic-— 


public void testParseHandler () 
finition processDe 


执行 
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form/leave .bpmn") 


Exception { 


repositoryService 
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mp] repositoryService] 


rocessDefinitionQuery () 


finition.getKey() ) ， 


， 查 看 控制 台 的 输出 结果 ， 验 证 User Task 是 否 被 


定义 对 象 的 属性 ， 不 会 在 数据 库 中 更 改 BPMN 文 件 内 容 。 


.SingleResult () ; 
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[1] http:/ /stackttace.be/blog/2013/03/dynhamic-ptocess-cteation-and-deployment-in-100-lines 


21.2 全 局 事件 处 理 器 


ntity.getActivities (); 


完 代码 清单 21-8 后 输出 的 结果 如 下 ， 从 结果 中 可 以 看 出 所 有 的 用 户 任务 类 型 的 异步 属性 均 为 true。 


，#2 和 #3 处 分 


结果 正确 ，#1 和 #2 处 的 断言 结果 为 true， 说 明代 码 清单 21-4 和 和 代码 清单 21-5 的 解析 处 理 器 正常 工作 了 ， 观 察 控 


让 设置 为 异步 。 


finition; 


别针 对 不 同 的 类 型 进行 


| 台 还 


擎 配置 对 象 中 设置 属性 customDefaultBpmnParseHandlers， 相 关 配 置 如 下 ， 实 现 类 


了 处 理 。 运 行 代码 清单 21-6 的 测试 后 观察 运行 结果 


#2 


不 可 以 看 到 如 下 的 输出 (代码 清单 21-5 中 #3 处 循环 语句 输出 的 内 


见 代码 清 


我 们 知道 流程 (Process) 可 以 定义 start、end 事 件 来 监听 流程 的 开始 与 结束 ， 也 可 以 在 用 户 任务 上 定义 任务 的 create、assignment、complete、delete 事 件 ， 可 以 在 输出 流 (flow) 上 定义 take 事 


件 。 


这 些 事件 监听 器 被 预先 分 散 地 定义 在 每 一 个 流程 文件 中 ， 如 果 某 个 流程 在 运行 中 需要 添加 一 个 监听 器 ， 


便于 日 后 的 维护 。 


有 没有 办 法 解决 这 些 问题 呢 ? 很 庆幸 ， 从 Activiti 5.15 版 本 开始 添加 了 全 局 事件 处 理 器 (Event handler) 。 


件 处 理 器 ， 因 为 这 些 事件 处 理 器 可 以 作用 于 一 个 引 | 全 


擎 实例 的 所 有 流程 或 者 作用 于 一 


只 全 5 许 
只 能 和 过 


选择 重新 设 ; 


在 官方 提供 的 用 户 手 册 中 没有 出 现 Global Event Handler， 
个 流程 实例 ， 而 不 是 把 事件 绑 定 在 某 一 个 活动 (Activity) 上 。 


流程 ， 然 后 部 署 。 另 外 很 多 功能 重复 的 监听 器 被 定义 在 不 同 的 流程 文件 中 也 不 


但 是 笔者 认为 应 该 翻译 为 全 局 事 


全 局 事件 处 理 器 这 种 事件 处 理 方式 的 工作 原理 是 在 某 一 个 事件 被 触发 时 由 引 警 发 送 通 知 (Notify) ， 根 据 事件 的 名 称 匹 配 所 有 注册 到 引擎 的 事件 处 理 器 ， 这 些 处 理 器 都 会 收 到 事件 通知 (典型 的 监听 者 
模式 ) : 可 以 在 引擎 配置 对 象 中 配置 事件 处 理 器 ， 也 可 以 在 流程 文件 中 配置 (只 能 在 Process 中 配置 ， 不 能 在 某 一 个 Activity 上 配置 ) ， 也 可 以 在 运行 时 通过 引擎 提供 的 API 添 加 事件 处 理 器 (不 过 运行 时 添加 
的 事件 处 理 器 仅 存 在 于 内 存 中 ， 重 启 引 警 后 就 会 被 销毁 ) 。 表 21-1 列 出 了 引 警 内 置 的 所 有 事件 名 称 及 事件 类 型 (类 名 为 ActivitiXxxEvent) 。 


表 21-1 引擎 内 置 的 事件 名 称 及 事件 类 型 


事件 名 称 描 述 事件 类 型 


监听 器 监听 的 流程 引擎 已 经 创建 完毕 ， 并 且 准 
备 好 接受 API 调用 


监听 器 监听 的 流程 引擎 已 经 关闭 ， 不 再 接受 
API 调用 


ENTITY_CREATED 创建 了 一 个 新 实体 ， 可 以 从 事件 中 获取 实体 ”| ActivitiEntityEvent 


ENGINE_CREATED ActivitiEvent 


ENGINE CLOSED ActivitiEvent 


创建 了 一 个 新 实体 ， 初 始 化 也 完成 了 。 如 果 这 
个 实体 的 创建 会 包含 子 实体 的 创建 ， 这 个 事件 会 
在 子 实体 都 创建 /初始 化 完成 后 被 触发 ， 这 是 与 
ENTITY _ CREATED 的 区 别 


ENTITY_INITIALIZED ActivitiEntityEvent 


更 新 了 已 存在 的 实体 ， 可 以 从 事件 中 获取 


ENTITY _ UPDATED ss ActivitiEntityEvent 
实体 
和 存在 的 实 休 可 以 从 事 本 
ENTITY DELETED ee 出 除 了 已 存在 的 实体 ， 可 以 从 事件 中 获取 ActivitiEntityEvent 
实体 
暂停 了 已 存在 的 实体 ， 可 以 从 事件 中 获取 实 
ENTITY SUSPENDED 体 。 会 被 ProcessDefinitions, ProcessInstances 和 | ActivitiEntityEvent 


Tasks 抛 出 


激活 了 已 存在 的 实体 ， 可 以 从 事件 中 获取 实 
ENTITY_ACTIVATED 体 。 会 被 ProcessDefinitions, ProcessInstances 和 | ActivitiEntityEvent 
Tasks 抛 出 


JOB_EXECUTION_SUCCESS 作业 执行 成 功 ，Job 对 象 包含 在 事件 中 ActivitiEntityEvent 
作业 执行 失败 。 作 业 和 异 稼 信息 包含 在 事 | ActivitiEntityEvent 


JOB_EXECUTION_FAILURE 


件 中 ActivitiExceptionEvent 
JOB_RETRIES_DECREMENTED | 叶 至 重 试 次 数 减少 。 作 业 ActivitiEntityEvent 
TIMER_FIRED AotivitiEntityEvent 
ACTIVITY_STARTED 一 个 节点 开始 执行 ActivitiActivityEvent 
ACTIVITY_COMPLETED 一 个 节点 成 功 结束 ActivitiActivityEvent 
ACTIVITY_TIMOUT 一 个 活动 的 定时 边界 事件 超时 ActivitiActivityEvent 


ACTIVITY_SIGNALED 一 个 节点 收 到 了 一 个 信号 ActivitiSignalEvent 


事件 名 称 


ACTIVITY_MESSAGE RECEIVED 


ACTIVITY_ERROR _ RECEIVED 


UNCAUGHT_BPMN_ERROR 


ACTIVITY_COMPENSATE 


VARIABLE CREATED 


VARIABLE _ UPDATED 


VARIABLE_DELETED 


TASK_CREATED 
TASK_ASSIGNED 


TASK_COMPLETED 


PROCESS_COMPLETED 


MEMBERSHIP_CREATED 


MEMBERSHIP_DELETED 


MEMBERSHIPS_DELETED 


21.2.1 定义 事件 处 理 器 


一 个 节点 收 到 了 一 个 消息 。 在 节点 收 到 消息 
之 前 触发 ， 而 在 收 到 后 ， 会 触发 ACTIVITY 
SIGNAL 或 ACTIVITY STARTED ， 根 据 节点 的 
类 型 (边界 事件 ， 事 件 子 流程 开始 事件 ) 不 同 触 
发 的 事件 也 不 同 


一 个 节点 收 到 了 一 个 错误 事件 。 在 节点 实际 
处 理 错 误 之 前 触发 。 事件 的 activityId 对 应 着 处 
理 销 误 的 节点 。 这 个 错误 发 送 成 功 ， 后 续 会 触 
人 ACTIVITY SIGNALLED 或 ACTIVITY 
COMPLETE 其 中 一 种 


抽出 了 未 捕获 的 BPMN 错误 。 流 程 没有 提供 
针对 这 个 错误 的 处 理 需 。 事件 的 activityId 为 空 

一 个 节点 将 要 被 补偿 。 事 件 包 含 了 将 要 执行 补 
偿 的 节点 id 

创建 了 一 个 变量 。 事 件 包 含 变量 名 、 变 量 值 和 
对 应 的 分 支 或 任务 (如 果 存 在 ) 

更 新 了 一 个 变量 。 事 件 包 含 变 量 名 、 变 量 值 和 
对 应 的 分 支 或 任务 (如 果 存 在 ) 

删除 了 一 个 变量 。 事 件 包 含 变 量 名 、 变 量 值 和 
对 应 的 分 支 或 任务 (如 果 存 在 ) 

创建 了 任务 实体 并 有 旦 任务 的 所 有 属性 都 已 设置 

任务 被 分 配给 了 一 个 人 人员。 事件 包含 任务 

任务 被 完成 了 。 它 会 在 ENTITY_DELETE 事 
件 之 前 触发 。 当 任务 是 流程 一 部 分 时 ， 事 件 会 
在 流程 继续 运行 之 前 , 后 续 事 件 将 是 ACTIVITY 
COMPLETE ， 对 应 着 完成 任务 的 节点 

流程 已 结束 ， 当 流程 的 最 后 一 个 活动 触发 了 
ACTIVITY_ COMPLETED 事件 后 该 事件 被 触发 


用 户 锌 添加 到 一 个 组 里 。 事 件 包 含 了 用 户 和 组 
的 id 


用 户 被 从 一 个 组 中 删除 。 事 件 包 含 了 用 户 和 组 
的 id 

所 有 成 员 被 从 一 个 组 中 删除 。 在 成 员 删 除 之 
前 触发 这 个 事件 ， 所 以 它们 都 是 可 以 访问 的 。 
从 性 能 方面 考虑 ， 不 会 为 每 个 成 员 触 发 单独 的 
MEMBERSHIP DELETED 事件 


( 续 ) 


we 


事件 类 型 


ActivitiMessageEvent 


ActivitiErrorEvent 


ActivitiErrorEvent 


ActivitiActivityEvent 


ActivitiVariableEvent 


ActivitiVariableEvent 


ActivitiVariableEvent 


ActivitiEntityEvent 


ActivitiEntityEvent 


ActivitiEntityEvent 


ActivitiEntityEvent 


ActivitiMembershipEvent 


ctiviti MembershipEvent 


ActivitiMembershipEvent 


预先 定义 事件 处 理 器 的 方式 有 两 种 : 在 引擎 配置 文件 中 定义 和 在 流程 文件 中 定义 。 事 件 处 理 器 均 需要 集成 自 接口 org.activiti.engine.delegate.event.ActivitiEventListener。 


1. 在 引擎 配置 文件 中 定义 


在 引擎 配置 对 象 中 配置 属性 “eventListeners”， 下 面 的 代码 列 出 了 相关 配置 。 而 事件 处 理 器 类 GlobalEventListener 的 实现 见 代 码 清单 21-9 所 示 ， 简 单 输出 所 有 的 事件 名 称 。 


<bean id="processEngineConfiguration" 
class="org.activiti .XxxE 


‘ngineConfiguration"> 


<property name="eventListeners"> 
<list> 


<bean class="me.kafeitu.activiti .chap 
.events .GlobalEventLi si 


ter21 
tener" /> 


</list> 
</property> 
</bean> 


代码 清单 21-9 ”事件 处 理 器 GlobalEventListener 


public class GlobalF 
QOverride 
public void onEvent (ActivitiEvent event) 


‘ventListener implements Activitii 


EventListener { 


{ 


System.out .println ("捕获 到 事件 : " + event.getType() .name () + ",， type=" 十 


ToStringBuilder.reflectionToString (event) ); 


QOverride 
public boolean isFailOnException() { 
return false; 


} 
} 


代码 清单 21-10 中 的 测试 类 运行 一 个 完整 的 流程 ， 测 试 代码 来 源 于 第 6 章 的 动态 表单 测试 代码 ， 不 过 由 于 篇 幅 有 限 不 再 重复 介绍 测试 用 例 。 


代码 清单 21-10 ”GlobalEventHandlerTest 


public class GlobalEventHandlerTest extends AbstractTest { 
@Test 
public void testEventListener() throws Exception { 
initProcessEngine ("chapter21/activiti.cfg.chapter21 .event .eventListener.xml"); 

deploy ("chapter21/leave.bpmn"); 


execute (); ”// 参考 LeaveDynamicFormTest 类 的 allApproved 方 法 


在 执行 完 代码 清单 21-10 的 测试 用 例 后 观察 控制 台 ， 输 出 的 内 容 如 下 ， 从 中 可 以 看 出 每 捕获 到 一 个 事件 后 控制 台 输出 。 


甫 获 到 事件 : ENGINE QI 
有 获 到 事件 : ENTITY CI 


EATED, type=org.activiti.engine.delegate.even 


t .impl .Activi 
EATED, type=org.activiti.engine.delegate.event.impl .Activi 
D |- 


R tiEventImplQ520b1684[type=ENGINE CREATED,executionId=<null>,processInstanceId=<null>,processDefini 
R tiEntityEventImpl@72a60191 [ent ity DeploymentEntityl[id=1, name=GlobalEventHandlerTest.allApproved],. 

获 到 事件 : ENTITY CREATED, type=org.activiti.engine.delegate.event.impl.ActivitiEntityEventImpl@525dc268 [entity=ProcessDefinitionEntity[leave:1:3],type=ENTITY CREATED,execution 
获 到 事件 : ENTITY INITIALIZED, type=org.activiti.engine.delegate.event.imp]l.ActivitiEntityEventImpl@75 6743 [entity=ProcessDefinitionEntity[leave:1:3],type=ENTITY INITIALIZED,e 
N ALIZ - [ 

[ 


获 到 事件 : ENTITY ED, type=org.activiti.engine.delegate.event.impl .ActivitiEntityEvent entity: DeploymentEntity[id=1, name=GlobalEventHandlerTest .allApprov 
甫 获 到 事件 : VAR ABLE CREATED, type=org.activiti.engine.delegate.event.impl.ActivitiVariableEventImpl@705baS0e[lvariableName=applyUserId,variableValue=henryyan, task1Id=<null>, type= 


ch rit 

号 
1O 
(ec 

| 
出 
MO 
Q 
一 ] 
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属性 “eventListeners” 定 义 的 事件 处 理 器 覆盖 了 全 部 类 型 的 事件 ( 见 表 21-1) ， 当 然 也 可 以 只 处 理 指定 类 型 的 事件 ， 把 属性 “eventListeners” 更 换 成 “typedEventListeners” 定 义 事件 类 型 与 事件 
处 理 器 的 映射 关系 。 下 面 代码 中 配置 了 两 个 事件 类 型 ， 每 个 事件 类 型 用 逗号 分 割 。 


<bean id="processEngineConfiguration" 
class="org.activiti .XxxEngineConfiguration"> 
<property name="typedEventListeners"> 
<map> 
<entry key="ENGINE CREATED,ENTITY CREATED"> 
<list> 加 加 
<bean class="me.kafeitu.activiti 
.Chapter21 .events.GlobalEventListener" /> 
</list> 
</entry> 
</map> 
</property> 
</bean> 


执行 下 面 的 测试 方法 ， 然 后 从 结果 中 过 滤 ， 可 以 看 到 只 有 定义 的 两 种 类 型 的 事件 被 触发 。 


@Test 
public void testTypedEventListener() throws Exception { 
initProcessEngine ("chapter21/activiti.cfg 
.Chapter21 .event .typedEventListener.xml"); 
deploy ("chapter21/leave.bpmn"); 
execute () ， 


2. 在 流程 文件 中 定义 


在 引擎 配置 文件 中 定义 的 事件 处 理 器 作用 域 是 整个 引擎 ， 也 就 是 说 引擎 中 所 有 流程 实例 触发 的 事件 均 会 被 定义 的 事件 处 理 器 捕获 ， 可 能 有 些 事件 只 作用 于 某 一 个 流程 ， 所 以 引擎 也 支持 在 流程 中 定义 事 
件 处 理 器 。 下 面 的 配置 在 流程 文件 的 BPM N 2.0 扩 展 标签 extensionElement 中 添加 一 个 “activitizeventListener” 标 签 ， 用 来 定义 和 当前 流程 有 关 的 事件 处 理 器 。 


<process ig="leave"” name=" 请 假 流程 "> 
<extensionElements> 
<activiti:eventListener class="me.kafeitu.activiti 
.Chapter21 .events.GlobalEventListener" /> 
</extensionElements> 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15030/0EBPS/Text/... 
</process> 


执行 下 面 的 单元 测试 后 分 析 控 制 台 的 输出 结果 ， 可 以 看 到 与 代码 清单 21-10 的 输出 结果 一 致 。 


GTest 
public void testEventInProcess () throws Exception 1{ 
initProcessEngine( 
"chapter21/activiti.cfg.chapter21 .event.default .xml"); 
deploy ("chapter21/leave-event .bpmn"); 
execute () ， 


在 流程 文件 中 除了 定义 一 个 事件 处 理 器 类 之 外 ， 还 可 以 把 捕获 的 事件 转换 为 消息 事件 、 信 号 事件 、 错 误 事 件 等 。 下 面 的 几 个 示例 配置 定义 了 事件 并 触发 其 他 事件 。 


以 下 配置 表示 : 当 触 发 TASK_CREATED 事 件 时 ， 抛 出 名 称 为 “SINGAL 001” 的 信号 事件 ， 当 然 也 可 以 抛 出 一 个 全 局 类 型 的 事件 (throwEvent= “globalSignal”) 。 


<process id="testEventListeners"> 
<extensionElements> 
<activiti:eventListener throwEvent="signal" 
signalName="SIGNAL 001 " events="TASK CREATED" /> 
</extensionElements> 因 
</process> 


以 下 配置 表示 : 当 触 发 TASK_CREATED 事 件 时 抛 出 一 个 名 称 为 “MSG _001” 的 事件 ， 通 过 这 个 信号 事件 可 以 启动 一 个 流程 或 触发 中 间 捕 获 事件 。 


<process id="testEventListeners"> 
<extensionElements> 
<activiti:eventListener throwEvent="message" 
messageName="MSG 001" events="TASK CREATED " /> 
</extensionElements> | 
</process> 
<process id="testEventListeners"> 
<extensionElements> 
<activiti:eventListener throwEvent="error" 
errorCode="ERR 001" events="TASK CREATED" /> 
</extensionElements> 
</process> 


回 说 明 全 局 事件 在 当前 Activiti 版 本 (5.15) 中 还 是 实验 性 的 ， 后 续 版 本 可 能 会 有 改动 。 


21.2.2 “处理 捕获 的 事件 


上 一 小 节 只 是 简单 介绍 了 如 何 定义 事件 处 理 器 ， 自 定义 的 事件 处 理 器 类 GlobalEvent-Listener 也 只 是 对 事件 的 类 型 做 了 输出 而 已 ， 本 小 节 将 详细 介绍 处 理 不 同类 型 的 事件 时 如 何 区 分 事件 类 型 ， 以 及 如 
何 获取 相关 数据 。 


在 代码 清单 21-9 中 ， 接 口 ActivitiEventListener 的 onEvent 方 法 的 ActivitiEvent 参 数 定义 了 事件 对 象 可 以 获取 的 一 些 参数 ， 例 如 获取 当前 事件 的 事件 类 型 、 流 程 实例 ID、 流 程 定 义 ID， 也 可 以 获取 
EngineServices 接 口 从 而 获取 引擎 的 7 个 Service 接 口 。 


为 了 更 清楚 地 了 解 不 同事 件 的 处 理 方式 ， 将 代码 清单 21-9 的 示例 加 以 改造 ， 需 要 针对 不 同 的 事件 做 一 些 翻译 工作 。 不 同类 型 的 事件 在 处 理 时 需要 将 类 型 强制 转换 成 具体 的 事件 对 象 ， 例 如 ， 在 代码 清单 
21-11 中 处 理 了 ENTITY_CREATED 事 件 ， 在 控制 台 打 印 是 哪个 实体 被 创建 。 


代码 清单 21-11 ”在 事件 处 理 器 中 区 分 不 同事 件 类 型 


public class GlobalEventListener implements ActivitiEventListener 1 
QOverride 
public void onEvent (ActivitiEvent event) { 
ActivitiEventType eventType = event.getType(); // 获取 事件 类 型 ( 枚 举 ) 
switch (eventType) { 
case ENGINE CREATED: 
System.out.println ("3 


擎 初始 化 成 功 ! "); 


Case ENGINE CLOSED: 
System.out .Println(" 引 擎 已 关闭 ! ") ; 
break; 

case ENTITY CRE 


ATED: 
// 类 型 强制 转换 为 实际 类 型 ， 参 考 表 21-1 


ActivitiEntityEvent entityEvent = (ActivitiEntityEvent) event; 
System.out .printlin ("创建 了 实体 ;: " + entityEvent.getEntity()); 
break; 

case ENTITY INITIALIZED: 
entityEvent = (ActivitiEntityEvent) event; 
System.out .printlin ("实体 初始 化 完毕 : " + entityEvent.getEntity()); 
break; 

defauilt: 
System.out .println ("捕获 到 事件 [需要 处 理 ]: " + eventType.name () + "， 


type=" + ToStringBuilder.reflectionToString (event)); 
} 
} 
QOverride 
public boolean isFailOnException() { return false;  } 


可 以 参照 代码 清单 21-11 中 的 代码 以 及 表 21-1 的 事件 类 型 与 事件 类 的 对 照 表 ， 添 加 不 同事 件 的 处 理 。 


事件 处 理 器 除了 实现 ActivitiEventListener 接 口外 还 可 以 继承 引 警 封装 的 基 类 ， 如 专门 用 来 处 理 实体 相关 事件 的 处 理 器 BaseEntityEventListener， 该 类 实现 ActivitiEventListener 接 口 并 过 滤 实 体 
(Entity) 类 型 的 事件 ， 封 装 了 onCreate()、oninitialized()、onDelete()、onUpdate0 方 法 来 处 理 不 同类 型 的 事件 ， 在 使 用 时 继承 该 类 并 覆盖 需要 的 方法 即 可 。 代 码 清单 21-12 列 出 了 继承 自 
BaseEntityEventListener 的 事件 处 理 器 类 EntityEvent-Listener。 


代码 清单 21-12 ”专门 用 来 处 理 实体 类 型 事件 的 事件 处 理 器 


public class EntityEventListener extends BaseEntityEventListener { 


QOverride 
protected void onCreate (ActivitiEvent event) { 
ActivitiEntityEvent entityEvent = (ActivitiEntityEvent) event; 


System.out.printlin ("创建 了 实体 : " + entityEvent); 
} 
QOverride 
protected void onInitialized (ActivitiEvent event) { 
super.onInitialized (event); 


QOverride 
protected void onDelete (ActiVvitiEvent event) { 
ActivitiEntityEvent entityEvent = (ActivitiEntityEvent) event; 


System.out.printlin ("删除 了 实体 : " + entityEvent); 
} 
QOverride 
protected void onUpdate (ActivitiEvent event) { 
super.onUpdate (event);}; 


} 

QOverride 

protected void onEntityEvent (ActivitiEvent event) { 
super.onEntityEvent (event); 


} 


代码 清单 21-12 的 测试 方法 如 下 ， 读 者 可 以 实际 操作 一 下 ， 然 后 观察 控制 台 打 印 的 结果 。 


@Test 
public void testEntityEvent () throws Exception { 
initProcessEngine\( 
"chapter21/activiti.cfg.chapter21 .event .entity.xml"); 
deploy ("chapter21/leave.bpmn"); 


execute () ， 


21.2.3 ”事件 处 理 器 的 异常 处 理 


事件 处 理 器 接口 ActivitiEventListener 中 的 isFailOnException() 方 法 的 作用 还 未 提 及 ， 该 方法 需要 返回 一 个 布尔 类 型 的 值 ， 其 返回 值 决定 了 当 方 法 onEvent( 抛 出 异常 时 引擎 如何 处 理 异常 : 当 返 回 的 值 为 
false 时 忽略 异常 程序 继续 执行 ， 当 返回 值 为 true 时 引擎 会 把 onEvent(0 抛 出 的 异常 继续 向 上 传播 。 所 以 一 般 会 在 事件 处 理 器 中 定义 一 个 成 员 变量 ， 在 方法 onEvent( 中 根据 不 同 条 件 决定 该 变量 的 true 与 
false。 代 码 清 单 21-13 展 示 了 一 个 处 理 异常 的 示例 。 


代码 清单 21-13 ”事件 处 理 器 的 异常 处 理 


public class EventExceptionListener implements ActivVitiEventListener { 
private boolean isFailOnException = false; 

QOverride 

public void onEvent (ActivitiEvent event) { 
ActivitiEventType eventType event .getType (); 


switch (eventType 


) 
case ENTITY CREATED: 
ActivitiEntityEvent entityEvent = (ActivitiEntityEvent) event; 
System.out .printlin ("创建 了 实体 ;: " + entityEvent.getEntity()); 
break; 
case ENTITY DELETED: 
entityEvent = (ActivitiEntityEvent) event; 
if (entityEvent.getEntity() instanceof TaskEntity) { 


“9 
isFailOnException = true; 


throw new RuntimeException(" 不 允许 删除 TaskEntity") ， 


} 


System.out .println(" 实 体 已 被 删除 " + entityEvent .getEntity() .getClass ()); 
break; 
} 
} 
QOverride 
public boolean isFailOnException() { 
return isFailOnException; 


} 


代码 清单 21-13 中 加 粗 部 分 判断 了 实体 的 类 型 ， 如 果 是 TaskEntity 类 型 ， 在 删除 时 抛 出 异常 并 设置 了 变量 isFailOnException 为 tue， 这 样 当 抛 出 RuntimeException 异 常 时 引擎 不 会 忽略 异常 而 是 继续 向 上 
传播 ， 最 终 导 致 操作 失败 ， 产 生 事务 回 滚 。 执 行 下 面 的 测试 后 单元 测试 执行 失败 ， 控 制 台 也 打印 了 异常 信息 。 


@Test 
public void testEventException() throws Exception { 
initProcessEngine( 
"chapter21/activiti.cfg.chapter21 .event .exception.xml"); 
deploy ("chapter21/leave.bpmn"); 
execute () ， 


控制 台 输 出 的 异常 信息 : 


Caused by: java.lang.RuntimeException: 不 允许 删除 TaskEntity 

at me.kafeitu.activiti.chapter?21 .events.EventExceptionListener.onEvent (Event-ExceptionListener.java:31) 

at org.activiti.engine.delegate.event.impl.ActivitiEventSupport.dispatchEvent (ActivitiEventSupport.java:104) 
http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15030/0EBPS/Text/... 40 more 


21.2.4 ”动态 注册 事件 处 理 器 


在 本 节 (21.2 节 ) 开头 提 到 了 可 以 动态 注册 、 删 除 事件 处 理 器 ， 值 得 注意 的 是 在 引擎 销毁 或 重新 启动 后 动态 注册 的 事件 处 理 器 将 被 销毁 ， 要 了 解 原因 首先 要 分 析 一 下 事件 处 理 器 的 管理 机 制 。 


在 初始 化 引擎 时 会 创建 一 个 空 的 事件 调度 器 (Event Dispatcher) ， 事 件 调度 器 在 内 部 会 维护 两 个 空 的 集合 ( 称 之 为 事件 处 理 器 池 ) : 一 个 是 处 理 所 有 类 型 的 事件 处 理 器 
(List<ActivitiEventListener> ) ， 另 外 一 个 是 区 分 事件 类 型 的 Map 集 合 (Map<ActivitiEventType，List<ActivitiEventListener> >) 。 


事件 调度 器 在 初始 化 完成 后 会 读 取 引擎 配置 文件 中 的 事件 处 理 器 集合 ， 然 后 加 入 到 事件 调度 器 中 。 在 读 取 一 个 流程 定义 时 需要 解析 流程 文件 ， 如 果 流 程 文 件 中 定义 了 事件 处 理 器 池 ， 从 流程 文件 中 获取 
的 事件 处 理 器 也 会 加 入 到 事件 调度 器 维护 的 事件 处 理 器 池 中 。 


为 了 动态 维护 事件 处 理 器 池 引 擎 开放 了 相应 的 接口 ， 在 RuntimeService 接 口中 有 以 下 几 个 方法 可 供 使 用 。 
void addEventListener(ActivitEventListener listenetrToAdd); 
“ void addEventListenet(ActivitEventListenet listenetrToAdd, ActivitEventTypehttp://www.hzcoutse.com/resoutce/readBook?path=/openresources/teach_ebook/uncompressed/15030/OEBPS/Text/...types); 
void temoveEventListenet(ActivitEventListenet listenerToRemove); 
可 以 使 用 addEventListener 方 法 增加 一 个 事件 处 理 器 (处 理 所 有 事件 类 型 ) ， 也 可 以 通过 types 参 数 限定 该 事件 处 理 器 支持 哪些 事件 类 型 ， 当 然 也 可 以 调用 方法 removeEventListener 移 除 一 个 事件 处 理 
器 。 
21.2.5 ”任务 自动 转 办 


想象 一 下 这 样 的 场景 : 员工 张 三 每 天 需要 在 系统 中 处理 大 约 10 项 待 办 任务 ， 因 为 公司 的 业务 发 展 需要 派 遗 张 三 到 外 地 出 差 一 周 ， 而 原本 的 日 常 工作 需要 在 公司 的 内 部 系统 中 处 理 (并 且 张 三 负责 的 任务 
在 整个 流程 中 比重 相对 较 高 ) 。 


张 三 在 外 地 如 何 处 理 日 常 的 工作 呢 ? 可 以 考虑 使 用 VPN 技 术 让 他 登录 到 公司 内 部 系统 ， 也 可 以 把 任务 转 办 给 其 他 的 同事 代办 。 本 节 内 容 就 来 讲解 一 下 如 何 实现 任务 的 自动 转 办 功能 。 


自动 转 办 指 分 配给 某 个 员工 的 任务 自动 转交 给 预 设 (任务 的 原 办 理 人 ) 的 转 办 人 。 当 然 转 办 可 以 配置 一 些 规则 或 者 限制 ， 例 如 可 以 设置 哪些 流程 、 哪 些 任务 ， 或 者 限制 在 一 段 时 间 之 内 待 办 任务 项 由 系 
统 自动 转 办 给 转 办 人 代办 。 


相对 于 自动 转 办 的 文字 描述 来 说 ， 在 Activiti 中 用 代码 实现 要 简单 得 多 ， 最 重要 的 一 个 动作 就 是 更 改 任务 的 办 理 人 (assignee) 属性 ， 当 然 在 更 改 办 理 人 属性 之 前 会 针对 一 些 条 件 做 出 判断 处 理 ， 只 有 在 
满足 预 设 的 条 件 之 后 才能 真正 把 任务 转 办 给 其 他 人 处 理 。 


任务 自动 转 办 的 实现 方式 有 两 种 ， 一 种 是 利用 引擎 提供 的 任务 监听 器 (UserTask 的 create 事 件 ) ， 另 外 一 种 就 是 利用 全 局 事件 处 理 器 (TASK_CREATED 事 件 类 型 ) 。 下 面 分 别 介绍 两 种 方式 的 实现 方 
ss 


1. 使 用 任务 监听 器 


在 本 章 源码 src/test/resources/chapter21/chapter21/leave-auto-delegate.bpmn 流 程 文件 中 ， 在 “销假 ”节点 处 添加 “create” 类 型 的 任务 监听 器 ， 相 关 配 置 如 下 : 


<userTask id="reportBack"” name=" 销 假 " 
activViti:assignee="S${fapp1yUserId}"> 
<extensionElements> 
<activiti:taskListener event="create" 
class="me. kafeitu.activiti. 
chapter21.1listeners.TaskAutoRedirectListener" /> 
</extensionElements> 
</userTask> 


TaskAutoRedirectListener 的 实现 代码 如 代码 清单 21-14 所 示 ， 在 代码 中 用 一 个 静态 的 Map 对 象 预先 定义 任务 办 理 人 的 转 办 关系 ， 在 实际 中 可 以 从 用 户 配 置 (保存 在 数据 库 ) 中 读 取 。 


代码 清单 21-14 TaskAutoRedirectListener 


public class TaskAutoRedirectListener implements TaskListener { 
private static Map<String, String> userMap = new HashMap<String, String>(); 
static { userMap.put ("henryyan", "thomas"); } 
QOverride 
public void notify(DelegateTask delegateTask) { 
String originAssginee = delegateTask.getAssiqnee(); // 原 任务 办 理 人 
String newUser = userMap.get (originAssginee); // 预 设 的 转 办 人 
if (StringUtils.isNotBlank (newUser)) { 


delegateTask.setAssignee (newUser); // 把 任务 重新 分 配给 转 办 人 


EngineServices engineServices = 


TaskService taskServic 


delegateTask.getExecution() .getEngineServices () ， 


= engineServices.getTaskService(); 


String message = getClass () .getName () + "-> 任务 [" + delegateTask. getName () + "] 的 办 理 人 [" + originAssginee + "] 自 动 转 办 给 了 用 户 [" + newUser + "]"; 
taskService.addComment (delegateTask.getId(),， // 记录 转 办 事件 


delegateTask.getProcessInstanceId(), "redirect", message); 


} else { 


System.out.println(" 任 务 [" + delegateTask.getName () + "] 没 有 预 设 的 转 办 人 ")，; 


} 


简单 分 析 一 下 代码 清单 21-14 的 监听 器 处 理 逻 辑 : 如 果 请 假 流 程 由 用 户 henryyan 发 起 ， 并 且 henryyan 用 户 预 先 设置 了 任务 自动 转 办 给 用 户 thomas， 结 果 销 假 节点 的 办 理 人 应 该 为 thomas 而 不 是 


henryyan。 


更 改 GlobalEventHandlerTest 类 的 execute() 方 法 中 的 销假 任务 办 理 人 断言 ， 用 来 验证 任务 的 办 理 人 为 henryyan， 以 此 判断 代码 清单 21-14 的 监听 器 是 否 执行 成 功 。 


String currentUserId = "henryyan"; 


Task reportBackTask = 


taskCom 


taskService.createTaskQuery() .singleResult () ， 


System.out .println ("任务 相关 事件 : " 


taskComment .getFull1M 


} 
// 判断 


assertEquals (currentUserId, report 


执行 下 面 的 单元 测试 验证 执行 结果 : 


QTest 


List<Comment> taskComments = taskService 
.getTaskComments (report] 
for (Comment taskComment : 


BackTask.getId()， "delegate"); 
ments) { 


十 


essage () ); 


BackTask.getAssignee()); 


public void testAutoRedirectUseTaskListener () { 
initProcessEngine( 


"chapter21/activi 


ti.cfg.chapter21 .event.default .xml"); 


deploy ("chapter21/leave-auto-redirect .bpmn"); 


execute () ， 


单元 测试 的 执行 结果 为 失败 ， 观 察 控制 台 可 以 看 到 如 下 的 输出 结果 : 


任务 相关 事件 : 


me.kafeitu.activiti.chapter21.listeners.TaskAutoRedirectListener-> 任务 [销假 ] 的 办理 人 [henryyan] 自动 转 办 给 了 用 户 [thomas] 
org.junit.ComparisonFailure: 


Expected :henryyan 
Actual :thomas 


2. 使 用 全 局 事件 处 理 器 


相对 于 使 用 监听 器 实现 任务 自动 转 办 来 说 ， 使 用 全 局 事件 处 理 器 来 实现 更 为 方便 ， 因 为 使 用 监听 器 方式 实现 必须 为 每 个 流程 的 用 户 任务 添加 “create” 监 听 器 ， 当 然 也 可 以 使 用 21.1 节 介绍 的 BPMN 解 
析 处 理 器 拦截 UserTask， 然 后 动态 添加 监听 器 实现 。 


使 用 全 局 事件 处 理 器 实现 任务 自动 转 办 需要 定义 TASK_CREATED 事 件 处 理 器 ， 该 事件 处 理 器 和 任务 的 “create” 监 听 器 类 似 ， 也 就 是 在 任务 对 象 初始 化 并 设置 好 所 有 属性 后 被 触发 。 


需要 提醒 读者 的 是 TASK_CREATED 事 件 从 Activiti 5.16 版 本 才 开始 支持 。 下 面 的 配置 代码 定义 了 一 个 TASK_CREATE 类 型 的 全 局 事件 处 理 器 。 


-1 


‘ventListeners"> 


<property name="typedFr 


<map> 


<entry key="TASK CREATED"> <! 一 5.16 版 本 开始 支持 --> 


<list> 


</list> 
</entry> 
</map> 
</property> 


<bean class="me. ka 
events.TaskAutoRedirectGlobal 


<!-- 任务 自动 转 办 --> 


feitu.activiti.chapter21. 
EventListener" /> 


代码 清单 21-15 的 处 理 逻 辑 与 代码 清单 21-14 类 似 ， 先 预先 设置 了 一 个 代办 对 应 关系 变量 userMap， 再 判断 实体 类 型 是 否 为 TaskEntity， 最 后 判断 任务 的 办 理 人 是 否 设置 了 代理 人 。 


代码 清单 21-15 TaskAutoRedirectGlobalEventListener 


public class TaskAutoRedirectGloball 
private static Map<String, S 


EventListener implements ActivitiEventListener 1{ 


tring> userMap = new HashMap<String, String>(); 


static { userMap.put ("henryyan", "thomas"); } 
QOverride 
public void onEvent (ActivitiEvent event) { 
ActivitiEntityEvent entityEvent = (ActivitiEntityEvent) event; 


Object entity 


= entityEven 


t .getEntity(); 


if (entity instanceof TaskEn 


rd 二 


tity) { // 用 户 任 务 类 型 的 实体 


task. se 


} 
} 


QOverride 


public boolean isFailOnl 


TaskEntity task = (TaskEntity) entity; 
tring originUser] 


S task.getAssignee () 
String newUserId = userMap.get (originUser1d); 
if (StringUtils.isNot] 


Blank (newUser1Id)) { 
tAssignee (newUserId); // 重新 设置 任务 办 理 人 


Exception() { return false; } 


执行 下 面 的 单元 测试 方法 观察 结果 ， 与 代码 清单 21-14 的 输出 结果 一 致 : 


QTest 


public void testAutoRedirectUseG] 


initProcessEngine 


oball 


Event () { 


( 


"chapter21/activiti.c 


fg .chapter2] 


execute () ， 


| .event .auto-redirect .xml"); 
deploy ("chapter21/leave.bpmn"); 


在 执行 上 面 的 单元 测试 后 ，Junit 提 示 断 言 失败 ， 控 制 台 输出 异常 信息 : 


org.junit.ComparisonFailure: 


Expected :henryyan 


Actual :thomas 


21.2.6 事件 日 志 


Activiti 5.16 版 本 新 增 了 全 局 事件 的 日 志 表 (ACT_EVT_LOG) 
中 。 值 得 注意 的 是 并 不 是 所 有 的 事件 都 会 被 记录 ，3 疆 


任务 相关 事件 类 型 


.TASK_CREATED， 任 务 创 建 。 


. TASK_COMPLETED， 任 务 完成 。 


. TASK_ASSIGNED,， 任务 分 配 办 理 人 。 


输出 流 相关 事件 类 型 : SEQUENCEFLOW _TAKEN， 执 行 Flow 时 。 


活动 (Activity) 相关 事件 类 型 : 


. ACTIVITY_COMPLETED， 活 动 完成 后 。 


. ACTIVITY_STARTED， 活 动 开始 执行 


. ACTIVITY_SIGNALED， 活 动 接 收 到 信号 


. ACTIVITY_MESSAGE_RECEIVED， 活 动 接 收 到 消息 。 


. ACTIVITY_COMPENSATE， 活 动 执 行 了 补偿 后 。 


. ACTIVITY_ERROR_RECEIVED， 活 动 接收 到 错误 信号 。 


变量 相关 事件 类 型 


:VARIABLE_CREATED， 
:VARIABLE_DELETED， 
-VARIABLE_UPDATED， 


开启 全 局 事件 日 志 功 能 可 以 设置 引擎 


a 


的 “enableDatabaseEventLogging ”和 @ 


， 该 功能 默认 未 启用 ， 要 启用 可 以 通过 更 改 引擎 配置 属性 来 实现 ， 开 启 全 局 事件 日 志 后 当 引 警 触发 全 局 事件 后 会 记录 到 表 ACT_EVT_LOG 
擎 预 设 了 以 下 几 大 类 事件 类 型 。 


参数 为 true， 相 关 配 置 如 下 : 


<bean id="processEngineConf 


igura 


Class="org.activiti .xxx.XxxProcessE 


<property name="enableDa 


</bean> 


tion" 


‘ngineConf 


iguration"> 


value="true" /> 


tabasel 


EventLogging" 


在 本 章 示 例 中 启动 一 个 流程 ， 然 后 再 观察 ACT_EVT_LOG 表 就 可 以 看 到 各 种 类 型 的 日 志 记 录 ， 如 图 21-6 所 示 。 


从 图 21-6 中 可 以 看 到 包含 了 


一 系列 和 流程 数据 有 关 的 日 志 ， 


读 取 到 日 志 数 据 后 需要 把 二 进 制 转 换 为 String 对 象 。 


“TYPE_ ”字段 为 事件 类 型 ，“DATA_“” 字段 为 日 志 内 容 ， 但 该 字段 的 值 为 二 进 制 类 型 (由 JSON 格 式 的 字符 串 序列 化 ) ， 在 通过 下 面 的 API 


ManagementService managementService = ... 


managementService.getr 


Event LogEn 


ntries (start, pageSize); 


eR 


ns _CREATED leave:1:31 nu da014-07-26 kermit |7b227661726961626c6554 
22:10:08.997 


2014-07-26 | 7b22746566e616e744964223 
22:10:09.006 


eo leave:1:31 7b226163746976697479496 
22:10:09.006 


当然 也 可 以 根据 流程 


|SEOUENCEFLOW TAKEN 


leave:1:31 


实例 ID 读 取 日 志 列 表 ， 代 码 如 下 : 


a014-07-26 7b226964223a22666C6f773 


22:10:09.007 


2014-07-26 kermit |7b226163746976697479496 
22:10:09.008 


2014-07-26 we tna 
22:10:09.011 


ACTIVITY_COMPLETED leave:1:31 2014-07-26 7b22616374697669747949€ 
22:10:09.007 


图 21-6 ACT_EVT_LOG 表 的 数据 


managementService. 


getEventLogEntries 


ByProcessI 


以 上 两 个 接口 均 返 回 


new String (1og] 


Entry.getData(), 


nstancel 


d (processI 


nstanceIQ) ， 


~ 一 


一 个 EventLogEntry 类 型 的 List 集 合 


"UTF-8") 


， 在 展示 日 志 


容 时 可 以 使 用 下 面 的 代码 把 EventLogEntry 的 getData() 方 法 返回 的 字 节 数 组 转换 为 字符 串 。 


转换 后 的 内 容 以 为 JSJON 字 符 串 ， 如 下 的 JSON 内 容 为 PROCESSINSTANCE START 事件 记录 。 


"tenantId": 
wd" . 102"; 
"createTime": 1406383809006, 
"timeSstamp": 1406383809006, 
"userId" : "kermit", 
"businessKey": "1"™, 
"processDefinitionId": "leave:1:31", 
"variables": { 

"applyUserIid": “kermit" 


T 
了 


} 


在 本 章 示例 的 “管理 ”菜单 添加 了 “事件 日 志 ” 菜 单项 ， 页 面 展示 的 效果 如 图 21-7 所 示 。 
单 击 图 21-7 中 的 “查看 ”按钮 可 以 查看 JJON 数 据 ， 在 遍历 JSON 数 据 后 逐 行 输出 到 如 图 21-8 的 对 话 框 中 展示 。 


有 关 代 码 读者 可 以 查看 本 章 示例 代码 的 EventLogController 类 及 event-logjjsp 文 件 。 


流程 实例 ID “执行 D 流程 定 ID 任务 iD ”发生 时 间 类 型 


i102 10a leave:1:31 Sat Jul 26 22:10:08 GST 2014 YARIABLE_CGREATED 


102 leave:1:31 Sat Jul 26 22:10:09 GST 2014 PROCESSINSTANCE_START 


i102 leave:1:31 Sat Jul 26 22:10:09 GST 2014 ACTIVITY STARTED 


102 eave:1:31 Sat JU| 26 22:10:09 GST 2014 ACTIVITY_GCOMPLETED 


laave:1:31 Sat Jul 28 22:10:09 CST 2014 SEQUENCEFLOW_TAKEN 


图 21-7 事件 日 志 列 表 


纸 


tenantld 
id 102 


createTime 1406383809006 
timeStamp 1406383809006 
userld CC kermlit 
businessKey 1 
processDefinitionld leave:1 .31 
varnables applyUserd: kermit 
lIogld event-log-2 


图 21-8 查看 日 志 详 细 


21.3 ”命令 与 拦截 器 


外 观 模式 (Facede) 、 命 令 模式 (Command) 、 拦 截 器 (Interceptor) 模式 是 常见 的 设计 模式 ， 也 是 Activiti 整 体 架 构 采用 的 三 种 主要 设计 模式 ， 所 有 的 API 均 以 这 三 种 模式 为 基础 实现 。 
“面向 接口 编程 ”是 Activiti API 设 计 的 一 大 设计 思想 ， 对 外 公开 的 所 有 API 均 用 抽象 定义 的 方式 ， 提 供 了 7 大 模块 的 XxxService 接 口 ， 这 也 是 采用 了 外 观 模式 的 表现 ; 引擎 的 内 部 实现 不 对 外 公开 ， 开 发 
人 员 只 要 调用 暴露 的 API 编 程 接口 实现 响应 的 功能 。 基 于 抽象 的 接口 还 可 以 覆盖 引擎 内 部 的 实现 ， 使 用 自 定义 的 实现 类 替换 (在 引擎 配置 对 象 中 可 以 配置 ) 。 


在 第 1 章 介绍 Activiti 特 性 时 就 提 到 了 命令 模式 ， 在 Activiti 中 所 有 的 操作 均 对 应 一 个 命令 接口 (Command) 实现 类 ， 这 样 不 同 的 功能 分 散在 N 个 命令 中 ， 易 于 维护 与 扩展 ; 当 调 用 引擎 XxxService 接 口 
时 实际 上 是 调用 不 同 的 Command， 但 接口 并 不 是 直接 调用 命令 ， 而 是 把 命令 交 给 CommandExecutor 统 一 执行 ， 因 为 通过 它 可 以 在 命令 执行 过 程 中 执行 若干 拦截 器 (类 似 JAVAEE 中 的 Filter 链 ) 。 


拦截 器 的 作用 顾名思义 ，Spring 中 的 AOP 就 是 一 个 典型 的 应 用 ， 可 以 在 方法 调用 之 前 或 之 后 执行 拦截 器 ， 从 而 实现 事务 管理 。 在 Activiti 中 拦截 器 也 发 挥 了 类 似 的 作用 ， 通 过 拦截 器 可 以 为 所 有 的 
Command 准 备 好 命令 上 下 文 (CommandContext) 对 象 ， 以 便 在 Command 实 现 类 中 获取 到 引擎 配置 对 象 (获取 引擎 配置 属性 ) 、 会 话 对 象 (Session) ， 以 及 其 他 扩展 属性 等 ; 还 可 以 为 Command 提 
供 事务 管理 器 、 乐 观 锁 自 动 重 试 等 功能 。 


21.3.1 命令 与 拦截 器 运行 机 制 


所 有 的 命令 均 需 要 实现 org.activiti.engine.impl.interceptor.Command 接 口 ， 该 接口 定义 见 代 码 如 下 : 


public interface Command <T> { 
T execute (CommandContext commandContext); 


} 


图 说 明 在 学 习 本 节 内 容 时 建议 用 IDE 打 开 Activiti 源 码 中 的 ProcessEngineConfiguration-Impl 类 查看 。 
该 接口 仅 定义 了 一 个 execute 方 法 ， 其 中 最 关键 的 是 该 方法 的 CommandContext 参 数 ， 该 参数 为 所 有 的 命令 提供 了 获取 数据 库 、 事 务 管理 器 、 扩 展 属性 等 资源 。 


引擎 在 初始 化 时 会 初始 化 一 系列 命令 拦截 器 ， 其 中 一 个 最 重要 的 拦截 器 为 CommandContextinterceptor， 接 口 Command 的 CommandContext 参 数 就 是 由 它 来 提供 。 要 分 析 拦 截 器 如 何 为 
Command 提 供 CommandContext 参 数 ， 需 要 先 了 解 一 下 Activiti 中 拦截 器 的 运行 过 程 。 


下 面 先 分 析 一 下 引擎 源码 中 的 一 段 有 关 默 认 拦 截 器 的 代码 片段 : 


protected Collection< ? extends CommandIinterceptor> 
getDefaultCommandInterceptors() { 
List<CommandIinterceptor> interceptors = 
new ArrayList<CommandIinterceptor> () ， 
interceptors.add (new LogInterceptor()); // 日 志 拦 截 器 
/ 


/ 事务 拦截 器 


CommandIinterceptor transactionIinterceptor = 
createTransactionIinterceptor () ， 
if (transactionInterceptor != null) 1{ 

interceptors.add (transactionInterceptor); 


} 

interceptors.adqd( // 命令 上 下 文 拦 截 器 
new CommandContextIinterceptor\( 
commandContextFactory, this)); 
return interceptors; 


再 来 分 析 读 取 所 有 拦截 器 的 initCommandlnterceptors 方 法 (): 


protected void initCommanadInterceptors () { 


if (commandqInterceptors==nul1) { 
commandIinterceptors = new ArrayList<CommandIinterceptor> () ， 
if (customPreCommandInterceptors!=null) { 


commandInterceptors // 自 定义 的 前 置 拦截 器 


.addAll (customPreCommandinterceptors); 


commandInterceptors // 默认 的 命令 拦截 器 

.addAll (getDefaultCommandg] | 

if (customPostCommandIinterceptors!=null) 
commandInterceptors // 的 局 入 六 各 兴 


.addAll (customPostCommandIinterceptors); 


} 
// 最 后 添加 命令 调用 者 CommandInvoker 
commandIinterceptors.add (new CommandInvoker ()); 


上 面 的 代码 用 于 设置 所 有 的 拦截 器 ， 这 包括 用 户 自 定 义 的 前 置 拦 截 器 、 默 认 拦截 器 、 用 户 自 定义 的 后 置 拦 截 器 ， 以 及 命令 调用 拦截 器 ， 其 中 Commandlnvoker 是 最 终 调用 命令 的 处 理 类 ， 在 调用 命令 时 
会 同时 把 CommandContext 对 象 传递 给 具体 的 命令 处 理 类 。 


所 有 的 拦截 器 均 实 现 接 口 Commandlnterceptor， 该 接口 的 定义 如 下 : 


public interface Commandinterceptor { 
<T> T execute (CommandConfig config, Command<T> command); 
CommandInterceptor getNext () ， 
void setNext (CommandIinterceptor next); 


接口 Commandinterceptor 提 供 了 next 参 数 的 getter 和 setter 方 法 ，next 参 数 为 下 一 个 拦截 器 的 对 象 引 用 ， 使 用 过 JAVAEE 中 Filter 链 的 读者 可 能 马上 就 明白 了 这 其 中 的 奥妙 了 ，NN 个 拦截 器 通过 next 属 
性 关联 就 形成 了 一 个 无 限 的 拦截 器 链 。 现 在 有 一 个 问题 要 抛 出 来 ， 哪 个 是 第 一 个 拦截 器 呢 ? 


在 上 面 的 getDefaultCommandlnterceptors() 方 法 中 首先 添加 的 是 日 志 拦截 器 ， 所 以 日 志 拦 截 器 会 作为 第 一 个 拦截 器 被 执行 ， 如 果 有 事务 拦截 器 ， 那 么 会 在 日 志 拦 截 器 执行 完成 后 被 调用 ， 最 后 才 是 命 
令 上 下 文 拦截 器 。 在 ProcessEngineConfigurationImp| 类 中 设置 断 点 后 可 以 看 到 如 图 21-9 所 示 的 结果 ， 很 清晰 地 展示 了 拦截 器 的 关联 关系 (先后 顺序 ) 。 


图 21-9 中 的 “first” 变 量 指 向 了 日 志 拦 截 器 Loglnterceptor 类 ， 该 拦截 器 会 先 输出 “starting XxxCmd” ， 然 后 调用 next 变 量 指向 拦截 器 的 execute 方 法 ， 依 次 循环 直到 所 有 的 拦截 器 都 执行 完成 。 


this = {org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration@2211} 
i st = {org.activiti.engine.impl.interceptor.Loginterceptor@2212} 

三 De {org.activiti.engine.impl.interceptor.CommandContextinterceptor@2222} 
bk 

bp 


二 commandContextFactory = {org.activiti.engine.impl.interceptor.CommandContextFactory@2223} 
二 processEngineConfiguration = {org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration@2211} 
bp 芝 next = {org.activiti.engine. [ap |.interceptor.Commandinvoker®@2224} 
so"commandinterceptors = {java.util.ArrayList®2213} size = 3 
bp 三 [0] = {org.activiti.engine.imp Lit interceptor.Loginterceptor@2212} 
bp 三 [1] = forg.activiti.engine.impl.interceptor.CommandContextinterceptor@2222)} 
bp 加 [2] = {org.activiti.engine.impl.interceptor.CommandiInvoker®@2224} 


图 21-9 ”在 ProcessEngineConfigutationImpl 类 中 断 点 查看 拦截 器 顺序 
了 解 了 拦截 器 的 串联 关系 ， 现 在 要 思考 另外 一 个 问题 : 第 一 个 拦截 器 如 何 被 调用 的 呢 ? 


在 本 节 内 容 开 头 提 到 过 的 CommandExecutor 类 用 来 统一 执行 所 有 的 命令 ， 该 类 在 初始 化 时 把 图 21-9 中 的 first 变 量 作 为 构造 参数 传递 ， 也 就 是 由 CommandExecutor 类 打开 了 命令 执行 的 大 门 。 下 面 的 


代码 取 自 源码 中 TaskServicelmpl 类 中 的 创建 新 任务 方法 ， 通 过 commandExecutor 执 行 一 个 命令 类 NewTaskCmd。 


public Task newTask (String taskId) { 
return commandExecutor.execute (new NewTaskCmd (taskIqd)); 


} 


21.3.2” 自 定义 命令 


擎 执行 ， 基 于 一 整套 完善 的 命令 与 拦截 器 运行 机 制 可 以 很 方便 地 实现 自 定 义 的 命令 ， 可 以 基于 引擎 原 有 功能 进行 扩展 。 


在 了 解 了 命令 与 拦截 器 的 运行 机 制 后 我 们 可 以 自 定 义 一 个 命令 交 给 


代码 清单 21-16 列 出 了 一 个 自 定义 命令 ,实现 了 更 改 任务 名 称 的 简单 功能 然后 在 代码 清单 21-17 中 执行 自 定义 命令 。 


代码 清单 21-16 ” 自 定义 命令 一 一 更 改 任务 名 称 


public class ModifyTaskNameCmd implements Command<Task> { 
protected String taskId; 
protected String taskName; 
public ModifyTaskNameCmd (String taskId, String taskName) { 
this.taskIq = taskId; 
this.taskName = taskName; 


} 
QOverride 
public Task execute (CommandContext commandContext 
// 获取 任务 实体 管理 器 ， 根 据 任务 ID 查 询 任 务实 体 对 象 
TaskEntityManager taskEntityManager = commandContext .getTaskEntityManager (); 
TaskEntity task = taskEntityManager.findTaskBylId (taskId) ， 
task.setName (taskName); 
task.update(); // 写 回 到 数据 库 


return task; 


~ 一 


{ 


代码 清单 21-17 ”执行 自 定义 命令 


@Test 
public void testCustomCommand() throws Exception { 
initProcessEngine ("chapter21/activiti.cfg.chapter21 .commangd.xml"); 
deploy ("chapter21/leave.bpmn"); 
ProcessInstance processInstance = startProcess (); 
// 验证 任务 名 称 
Task task = taskService.createTaskQuery () 
.DrocessInstanceId (DrocessInstance.dgetId()) .singleResult () ， 
assertEquals (" 部 门 领导 审批 "，task.getName () ) ; 
managementService.executeCommand( // 执行 自 定义 的 命令 
new ModifyTaskNameCmd (task.getId(), task.getName() + "-Modified")); 
task = taskService.createTaskQuery () .singleResult () ; 
assertEquals ("部 门 领导 审批 -Modified",， task.getName () ) ; 


在 代码 清单 21-17 的 单元 测试 代码 中 首先 启动 了 流程 ， 接 着 验证 待 办 任务 的 名 称 是 否 为 “部 门 领导 审批 ”， 然 后 执行 代码 清单 21-16 的 自 定义 命令 ,最 后 验证 结果 是 否 正 确 。 


代码 清单 21-16 是 一 个 简单 的 命令 实现 ， 目 的 是 让 读者 快速 了 解 命 令 的 定义 及 执行 。 而 代码 清单 21-18 则 是 一 个 实用 的 命令 实现 ， 可 以 不 经 过 预 设 的 输出 流 直 接 跳跃 到 其 他 节点 ， 也 就 是 常 说 的 “任意 节 
点 跳 转 ”功能 。 命 令 JumpActivityCmd 使 用 了 引擎 内 部 未 公开 的 API 实 现 节点 跳 转 动作 ， 本 节 不 做 详细 介绍 ， 作 为 内 容 即 可 。 


代码 清单 21-18 节点 跳 转 命令 JumpActivityCmd 


public class JumpActivitycmd implements Command<ExecutionEntity> { 
private 号 tring act tivityId; 
private String processInstancelIgd; 
public JumpActivitycmad (String processinstanceld, String activityId) { 
this.activitylId = activityld; 
this.processInstanceld = processInstanceld; 


} 
public ExecutionEntity execute (CommandContext commandContext) { 
// 查询 活动 的 分 支 

ExecutionEntity executionEntity = commandContext .getExecutionEntityManager () 
.findExecutionById (ProcessInstanceId) ， 
executionEntity.destroyScope ("jump"); // jump 参 数 为 销毁 的 原因 
// 从 流程 定义 中 查询 目标 Activity 

ProcessDefinitionImpl processDefinition = executionEntity.getProcessDefinition(); 
ActivityImpl activity = DrocessDefinition.findqActivity(activityId) 
executionEntity.executeActivity(activity); // 节点 跳 转 到 目标 活动 

return executionEntity; 


代码 清单 21-19 的 单元 测试 用 来 执行 代码 清单 21-18 的 JumpActivityCmd 命 令 ， 并 且 验 证 该 命令 是 否 发 挥 了 应 有 的 作用 |。 


代码 清单 21-19 ”测试 节点 跳 转 命令 JumpActivityCmd 


@Test 

public void testCustomCommandJump () throws Exception { 
initProcessEngine ("chapter21/activiti.cfg.chapter21 .commangd.xml"); 
deploy ("chapter21/leave.bpmn"); 
ProcessInstance processInstance = startProcess (); 
// 验证 任务 名 称 
Task task = taskService.createTaskQuery() .singleResult ()，; 
assertEquals ("部 门 领导 审批 "，task.getName () ); 
managementService.executeCommand ( // 直接 跳 续 到 销假 节点 

new JumpActivityCmd (processInstance.getId(), "reportBack")); 

task = taskService.createTaskQuery () .singleResult () ; 
assertEquals ("销假 "，task.getName () ) ; 


代码 清单 21-19 单 元 测试 执行 成 功 ， 表 示 任 务 节点 被 跳 转 到 了 “销假 ”节点 ， 中 间 跳 过 了 “人 事 审批 。， 这 个 功能 可 以 在 特殊 情况 下 使 用 。 


21.3.3 命令 拦截 器 


在 21.3.1 小 节 中 详细 介绍 了 命令 与 拦截 器 的 执行 机 制 ， 并 且 提 到 了 自 定义 命令 拦截 器 (分 为 前 置 和 后 置 ) ， 本 小 节 将 介绍 如 何 定义 、 配 置 自 定义 的 命令 拦截 器 。 


我 们 分 别 定义 两 个 类 型 的 命令 拦截 器 来 演示 前 置 与 后 置 拦截 器 ， 代 码 清单 21-20 列 出 了 前 置 拦 截 器 类 MyPreCommandinterceptor， 代 码 清单 21-21 列 出 了 后 置 拦 截 器 类 
MyPostCommandlnterceptor， 在 这 两 个 拦截 器 中 简单 打印 了 被 拦截 的 命令 。 


代码 清单 21-20 ”前 置 命令 拦截 器 


public class MyPreCommanadInterceptor extends AbstractCommandIinterceptor { 


QOverride 
public <T> T execute (ComandConfig config, ne command) { 
System.out.println(" 前 置 傅 令 拼 吉 器- ->: " + command 


return next .execute (config, commangd); // 呆 训 行 不- 个 拦截 器 


代码 清单 21-21 后 置 命 令 拦截 器 


public class MyPostCommandInterceptor extends AbstractCommandIinterceptor { 


QOverride 
public <T> T execute (CommandConfig config, nn” command) { 
System.out.printin(' ("后 轩 命 令 拦截 器 - ->: " + command 


return next.execute (config, command); // 继 答 全 下 一 个 拦截 器 


自 定义 拦截 器 需要 在 引擎 配置 对 象 中 定义 ， 下 面 的 代码 在 引擎 配置 对 象 中 分 别 为 前 置 和 后 置 命 令 拦截 器 集合 注入 了 自 定义 命令 拦截 器 实现 类 。 


<bean id="processEngineConfiguration" class="org.activiti.enginenttp://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15030/0EBPS/Text/. .XxxPrc 
<property name="databaseSchemaUpdate" value="true"/> 
<! 一 前 置 命令 拦截 器 集合 属性 --> 
<property name="customPreCommandIinterceptors"> 
<list> 
<bean class="me.kafeitu.activiti.chapter21 
.Command.MyPreCommandInterceptor"></bean> 


</list> 
9 
<! 一 后 置 命令 拦截 器 集合 属性 --> 
<property ee Interceptors"> 
<list> 


<bean class="me.kafeitu.activiti.chapter21 
.Command.MyPostCommandInterceptor"></bean> 


</list> 
</property> 
</bean> 


现在 表 执 行 代码 清单 21-19 的 单元 测试 ， 观 察 控制 台 (过 滤 字 符 “ 拦 截 器 ”) 可 以 看 到 如 下 的 输出 : 


前 置 命令 拦截 器 ->: org.activiti.engine.impl.SchemaOperationsProcessEngineBuild@904eabb 
后 置 命令 拦截 器 ->: org.activiti.engine.impl.SchemaOperationsProcessEngineBuild@904eabb 
前 置 命令 拦截 器 ->: org.activiti.engine.impl.cmd.DeployCmd@43277a30 

后 置 命令 拦截 器 ->: org.activiti.engine.impl.cmd.DeployCmd@43277a30 

前 置 命令 拦截 器 ->: org.activiti.engine.impl.cmd.GetNextIdBlockCmd@56ce3b62 

后 置 命令 拦截 器 ->: org.activiti.engine.impl.cmd.GetNextIdBlockCmd@56ce3b62 

前 置 命令 拦截 器 ->: org.activiti.engine.impl.ProcessDefinitionQueryImpl1@2d97qd09f 

后 置 命令 拦截 器 -> org.activiti.engine.impl.ProcessDefinitionQueryImpl@2d97d09f 

前 置 命令 拦截 器 ->: org.activiti.engine.impl.cmd.SubmitStartFormCmd@2d6f4ce0 

后 置 命令 拦截 器 ->: org.activiti.engine.impl.cmd.SubmitStartFormCcmd@2d6f4ce0 

前 置 命令 拦截 器 ->: org.activiti.engine.impl.TaskQueryImpl@758c3b7 

后 置 命令 拦截 器 ->: org.activiti.engine.impl.TaskQueryImpl@758c3b7 

前 置 命令 拦截 器 ->: me.kafeitu.activiti.chapter21.command.JumpActivityCcmd@7aa36771 

后 置 命令 拦截 器 ->: me.kafeitu.activiti.chapter21.command.JumpActivityCmd@7aa36771 

前 置 命令 拦截 器 ->: org.activiti.engine.impl.TaskQueryImpl@1le605ble 

后 置 命令 拦截 器 ->: org.activiti.engine.impl.TaskQueryImpl@le605ble 


21.4 流程 虚拟 机 一 一 PVM 


Java 语 言 是 跨 平 台 的 ， 这 得 益 于 强大 的 JVM (Java Virtual Machine， 即 Java 虚 拟 机 ) ， 它 是 一 个 使 用 软件 技术 虚构 出 来 的 一 台 计 算 机 ， 提 供 了 一 套 计算 有 关 规 范 ， 不 同 的 操作 系统 按照 规范 有 不 同 的 
实现 方式 ， 但 是 对 外 接受 计算 请 求 有 统一 的 接口 。 


PVM (Process Virtual Machine， 即 流程 虚拟 机 ) ， 是 Activiti 整 个 流程 驱动 (也 叫 流程 推进 ) 机 制 的 核心 规范 。 和 JVM 类 似 ，PVM 是 规范 而 不 是 具体 的 实现 。PVM 最 早 在 jBPM4 时 提出 ， 也 是 jBPM4 
作者 Tom Baeyens (当时 就 职 于 JBoss 公司 ) 推崇 的 规范 。 遗 憾 的 是 jBPM5 放 弃 了 PVM 而 选择 使 用 Drools Flow 开 发 新 的 流程 引擎 ， 可 能 这 也 是 导致 Tom Baeyens 离 开 JBoss 后 基于 PVM 开 发 一 套 新 的 工作 
流 引 警 的 原因 之 一 。 


21.4.1 简 述 PVM 


在 Activiti 源 码 中 针对 PVM 的 规范 定义 了 一 些 接口 以 及 抽象 类 ，Activiti 实 现 BPM N 2.0 规 范 中 的 元 素 全 部 基于 PVM 的 这 些 抽象 类 ， 不同 的 元 素 虽 然 拥有 相同 的 命令 接口 但 是 处 理 命令 的 方式 不 同 ， 这 样 
不 同 的 元 素 实现 由 PVM 串 联 成 一 个 完整 的 流程 。 在 Activiti 中 仅仅 有 PVM 还 是 不 够 的 ， 不 同 的 BPMN 2.0 行 为 (Behavior) 实现 类 还 使 用 了 Petri-Net ( 佩 特 里 网 ) 【| 与 UML Activity Graph 两 种 数学 与 图 形 
表示 方式 。 


大 家 常用 的 Java 虚 拟 机 是 由 Oracle ( 原 公司 Sun 被 Oracle 收 购 ) 公司 开发 的 Oracle JVM ， 当 然 也 有 其 他 的 JVM 实 现 ， 例 如 OpenJDK 提 供 的 JVM。 我 们 开发 的 一 般 应 用 可 以 在 两 种 虚拟 机 上 运行 ， 这 是 
因为 两 种 虚拟 机 实现 的 规范 大 致 相同 。 同 理 ，PVM 也 可 以 做 到 通用 ， 在 Activiti 中 有 一 套 基于 PVM 的 实现 ， 我 们 自己 也 可 以 基于 PVM 开 发 出 自己 的 流程 引擎 ， 当 然 自 己 实现 BPMN 规 范 需 要 很 大 的 工作 量 ， 
这 也 是 为 什么 Activiti 到 目前 为 止 还 没有 完全 覆盖 BPMN 2.0 规 范 所 有 元 素 的 原因 之 一 。 


21.4.2 Hello PVM 


虽然 我 们 不 太 可 能 基于 PVM 开 发 出 一 套 新 的 流程 引擎 ， 但 是 我 们 可 以 通过 一 些 简 单 的 代码 来 了 解 PVM 是 如 何 运行 的 ， 这 样 也 可 以 更 好 地 理解 Activiti 中 流程 驱动 的 深层 次 原理 。 在 Activiti 源 码 中 有 大 量 
有 关 PVM 的 测试 用 例 ， 这 是 我 们 学 习 和 理解 PVM 的 一 个 很 好 的 途径 ， 有 兴趣 的 读者 可 以 搜索 源码 中 包含 PVM 的 Java 类 。 


很 多 读者 对 PVM 还 有 些 陌 生 ， 所 以 我 们 从 最 简单 的 示例 开始 讲解 。 图 21-10 展 示 了 一 个 简单 的 流程 图 ， 包 含 开始 、 用 户 任务 、 结 束 三 个 流程 活动 。 我 们 可 以 通过 创建 三 种 不 同 的 活动 对 象 分 别处 理 各 自 
的 功能 ， 最 后 调用 PVM 的 API 执 行 整个 流程 ， 具 体 的 实现 代码 参见 代码 清单 21-22。 


图 21-10 ”一 个 简单 的 流程 图 


代码 清单 21-22 Hello PVM 


public class PvmTest { 
@Test 
public void helloPpvm() { 
// 创建 开始 活动 
ActivityBehavior startBehavior = new ActivityBehavior() { #1-S 
QOverride 
public void execute (ActivityExecution execution) throws Exception { 
System.out .println(" 处 理 开 始 节点 ") ; #1—1 
List<PvmTransition> transitions = execution // 查询 输出 流 
.getActivity() .getOutgoingTransitions(); #1-2 
execution.take (transitions.get (0)); // 转向 输出 流 #1 一 


} 
}; 
// 创建 用 户 任务 活动 
ActivityBehavior userTaskBehavior = new ActivityBehavior() { #2-S 
QOverride 
public void execute (ActivityExecution execution) throws Exception { 
System.out .println (" 处 理 用 户 任务 ") ; 
List<PvmIransition> transitions = execution 
.getActivity() .getOutgoingTransitions ();} #2-1] 
execution.take (transitions.get (0)); #2-E 


} 
}; 
// 创建 结束 活动 


ActivityBehavior endBehavior = new ActivityBehavior() 1{ #3-S 
QOverride 
public void execute (ActivityExecution execution) throws Exception 


System.out .println(" 处 理 结束 节点 ") ; 
} 
}; #3-E 
// 创建 流程 定义 构造 器 
ProcessDefinitionBuilder builder = new ProcessDefinitionBuilder (); #4 
builder.createActivity("start") // 设置 活动 的 名 称 #5-S 


.initial() // 标记 为 起 始 节点 
.behavior (startBehavior) // 活动 处 理 器 
.transition ("userTask") // 下 一 个 执行 的 活动 


.engdActivity(); // 结束 当前 活动 #5 一 EE 
// 创建 用 户 任务 
builder.createActivity("userTask") .behavior (userTaskBehavior) #6 


.transition ("end") .endActivity(); 


// 创建 结束 节点 


builder.createActivity("end") .behavior (endBehavior) .endActivity(); #7 
// 构建 PVM 流 程 定义 
PvmProcessDefinition pvmProcessDefinition = builder.buildProcess Definition(); #8 
PvmProcessInstance processInstance = // 创建 PVM 流 程 实例 #9-S 
pvmProcessDefinition.createProcessInstance () ; 
processInstance.start(); // 启动 流程 #9 


代码 清单 21-22 的 #1、#2、#3 处 分 别 基 于 ActivityBehavior 接 口 创建 了 三 个 匿名 类 ，#1 处 的 startBehavior 用 来 处 理 图 21-10 中 的 “开始 ”活动 ，#2 处 的 userTaskBehavior 用 来 处 理 图 21-10 中 的 “用 户 
任务 ”活动 ，#3 处 的 endBehavior 用 来 处 理 图 21-10 中 的 “结束 ”活动 ， 其 中 #1-2、#2-1 处 从 ActivityExecution 对 象 中 获取 到 当前 活动 的 输出 流 (也 可 以 称 为 转向 或 者 连 线 ) ， 输 出 流 可 能 会 有 多 个 ， 所 以 
execution.getActivity0 得 到 的 是 一 个 集合 ， 这 里 为 了 简单 起 见 只 处 理 第 一 个 输出 流 。 当 前 活动 的 输出 流 是 如 何 设 置 的 呢 ? 带 着 这 个 问题 我 们 继续 向 下 看 代码 。 


#4 处 创建 的 ProcessDefinitionBuilder 对 象 专门 用 来 构建 ProcessDefinition (流程 定义 ) ， 在 执行 完 #5 处 的 代码 后 就 创建 了 一 个 名 称 为 “start” 的 活动 并 声明 这 是 起 始 节 点 ， 该 活动 的 处 理 器 设置 为 
startBehavior 对 象 ， 也 就 是 说 当 流 程 运行 到 名 称 为 start 的 节点 时 执行 startBehavior 类 对 象 ， 执行 完 成 后 把 输出 流 指 向 名 称 为 “userTask” 的 活动 。#6、#7 处 分 别 创建 了 用 户 任务 和 结束 活动 的 属性 ， 然 后 
在 #8 处 使 用 构造 器 构建 一 个 PvmpProcessDefiniton 对 象 。 这 一 过 程 与 前 面 章节 介绍 的 类 似 ， 使 用 流程 设计 器 设计 流程 相当 于 代码 清单 21-22 中 #5、#6、#7 处 的 流程 活动 关联 配置 ，#8 处 构建 流程 定义 对 象 
相当 于 部 署 流程 文件 。 


#9 处 则 相当 于 调用 了 runtimeService.startProcessinstanceByXxx() 方 法 启动 一 个 流程 返回 一 个 流程 实例 。 最 后 运行 代码 清单 21-22 中 的 单元 测试 ， 观 察 控制 台 的 输出 可 以 看 到 如 下 的 输出 : 


处 理 开 始 节 后 


10:12:45,203 [main] DEBUG org.activiti.engine.impl.pvm.runtime.AtomicOperationTransi tionNotifyListenerTake - ProcessInstance[1310188746] takes transition (start)--> (userTask) 
10:12:45,204 [main] DEBUG org.activiti.engine.impl.pvm.runtime.AtomicOperation ActivityExecute - ProcessInstance[1310188746] executes Activity (userTask) : me.kafeitu.activiti.ctrk 
处 理 用 户 任务 

10:12:45,204 [main] DEBUG org.activiti.engine.impl.pvm.runtime.AtomicOperationTransitionNotifyListenerTake - ProcessInstance[1310188746] takes transition (userTask)--> (end) 

LO TL 2 45, 205 [main] DEBUG org.activiti.engine.impl.pvm.runtime.AtomicOperation ActivityExecute - ProcessInstance[1310188746] executes Activityl(end): me.kafeitu.activiti.chapter 
处 理 结束 节点 


21.4.3 ”PVM 进 阶 


执行 代码 清单 21-22 后 启动 了 一 个 流程 ， 接 着 控制 台 打 印 了 三 个 活动 的 全 部 输出 信息 ， 按 照 我 们 在 Activiti 中 设计 的 流程 ， 应 该 是 启动 流程 后 停留 在 “用 户 任务 ”节点 ， 等 待 用 户 触发 后 继续 执行 后 续 活 
动 。 
代码 清单 21-23 定 义 了 一 个 自动 执行 的 活动 类 Automatic， 代 码 清单 21-24 定 义 了 一 个 等 待 类 型 的 活动 类 Waitstate。 


代码 清单 21-23 ”自动 执行 活动 实现 类 Automatic 


public class Automatic implements ActivityBehavior { 
public void execute (ActivityExecution execution) throws Exception { 
List<PvmTransition> outgoingTransitions = execution 
.getActivit 9 CA 
if (outgoingTransitions.isEmpty 


execution.end(); // 刀 果 器 闪 后 奈 的 输 册 流 ， 结束 ActivityExecution 

System.out.println ("流程 已 结束 ， 结 束 节 点 : " + execution.getActivity() .getId() ) 
} else { 

System.out .println ("自动 节点 : " + execution.getActivity() .getId()); 


execution.take (outgoingTransitions.get (0)); 


代码 清单 22-23 中 处 理 了 两 种 情况 ， 如 果 当 前 活动 还 有 后 续 输出 流 ， 则 执行 ， 否 则 结束 ActivityExecution， 根 据 活动 是 否 并 行 、 多 实例 判断 是 结束 流程 还 是 结束 一 个 分 支 (Execution) 。 


代码 清单 21-24 ”支持 等 待 功能 的 活动 实现 类 WaitState 


public class WaitState implements SignallableActivityBehavior { 
public void execute (ActivityExecution execution) throws Exception 
System.out.println ("节点 " + execution.getActivity() .getId() + "被 本 发 ; ; 


} 
public void signal (ActivityExecution execution, String signalName, Object signalData) 
throws Exception { 
PvmActivity activity = execution.getActivity(); 
System.out.println ("触发 活动 " + activity.getId()); 
PvmIransition transition = activity.getOutgoingTransitions() .get (0) ， 
execution.take (transition); 


代码 清单 22-24 和 代码 清单 22-23 就 有 一 些 区 别 了 ， 类 WaitState 实 现 的 接口 不 是 ActivityBehavior 而 是 SignallableActivityBehavior， 理 解 为 可 以 接收 信号 的 活动 处 理 器 。 该 接口 继承 自 
ActivityBehavior， 定 义 了 一 个 sienal0 方 法 ， 可 以 接受 信号 (signalName 参 数 ) 和 信和 号 相关 的 数据 (signalData 参 数 ) ; 从 ActivityBehavior 继 承 来 的 execute( 方 法 用 来 处 理 具体 的 活动 任务 。 


以 图 21-6 的 流程 图 为 例 ， 代 码 清单 22-25 列 出 了 相关 测试 类 ， 依 赖 了 代码 清单 22-23 和 代码 清单 22-24 的 两 个 活动 类 。 
代码 清单 21-25 ”测试 等 待 发 送信 号 的 活动 处 理 器 


QTest 
public void pvmSignalTask() { 
// 创建 流程 定义 构造 器 
ProcessDefinitionBuilder builder = new ProcessDefinitionBuilder(); 
builder.createActivity(' 'start") 设置 活动 的 名 称 
.initial() // 标记 为 起 始 节点 
.behavior (new Automatic () ) // 活动 处 理 器 
.transition ("userTask") // 下 一 个 执行 的 活动 
.endActivity(); // 结束 当前 活动 
// 创建 用 户 任务 
builder.createActivity("userTask") .behavior (new WaitState () ) 
.transition ("end") .endActivity(); 
// 创建 结束 节点 
builder.createActivity("end") .behavior (new Automatic()) .endActivity/(); 
// 构建 PVM 流 程 定义 
PvmProcessDefinition pvmProcessDefinition = builder.buildProcessDefinition(); 
// 创建 PVM 流 程 实例 


PvmProcessInstance processInstance = pvmProcessDefinition.createProcess Instance () ， 
processInstance.start(); // 启动 流程 
processInstance.signal ("userTask"，null); // 触发 等 待 的 活动 (userTask) 


在 讲解 代码 清单 22-25 之 前 先 查看 一 下 运行 结果 ， 控 制 台 的 输出 如 下 : 


自动 节点 : start 

节点 userTask 等 竺 被 触发 
es 

流程 已 结束 ， 节点 : end 


在 代码 清单 22-25 中 最 关键 的 一 行 代码 就 是 最 后 一 行 ， 调 用 了 processinstatnce 的 signal0 方 法 。 读 者 可 以 把 这 一 行 代 码 注释 掉 再 运行 ， 结 果 如 下 所 示 ，userTask 一 直 等 待 被 触发 流程 没有 继续 执行 。 


自动 节点 : start 
节点 userTask 等 待 被 触发 


通过 本 小 节 的 学 习 可 以 简单 总 结 一 下 Activiti 中 BPMN 2.0 规 范 的 活动 类 是 如 何 实现 的 : 所 有 的 自动 节点 (包括 开启 、 结 束 、Service Task、 输 出 流 等 ) 实现 的 ActivityBehavior 接 口 被 触发 后 直接 把 相应 
的 任务 处 理 完成 ， 所 有 的 等 待 节 点 (用 户 任务 、 中 间 捕 获 事 件 等 ) 执行 完 ActivityBehavior 接 口 的 execute 方 法 后 并 没有 流转 到 下 一 节点 ， 而 是 等 待 接收 信号 后 才 流转 到 下 一 节点 ， 也 就 是 调用 
SignallableActivityBehavior 接 口 的 signal 方 法 。 


[1] http:/ /zh.wikipedia.otg/wiki/Petti 网 


21.5 ”本章 小 结 
前 面 所 有 章节 都 在 讲解 如 何 使 用 Activiti， 而 本 章 则 深层 次 剖析 Activitij 是 怎么 运转 的 ， 这 些 内 容 能 够 让 读者 更 加 深入 地 了 解 Activiti 的 运行 原理 ， 我 们 把 一 个 完整 的 引擎 拆 解 开 来 摆 在 眼前 ， 使 大 家 一 目 了 


本 章 从 应 用 的 角度 开始 ， 首 先 讲解 了 引 警 如何 解析 BPMN 文 件 ， 如 何 用 代码 的 方式 动态 创建 一 个 流程 并 启动 ， 并 且 在 引擎 解析 BPM N 文 件 时 通过 注入 的 方式 在 拦截 解析 过 程 中 加 入 自己 的 逻辑 处 理 。 全 
局 事件 是 引擎 留 给 我 们 的 一 个 拦截 运行 过 程 的 一 个 方便 的 入 口 ， 利 用 全 局 事件 监听 多 种 类 型 的 事件 ， 利 用 这 些 事件 可 以 实现 一 些 通用 的 功能 或 记录 日 志 。 


接着 介绍 了 Activiti 如 何 定义 、 使 用 命令 与 拦截 器 ， 详 细 介绍 了 引擎 如 何 为 命令 类 提供 所 需 数据 (例如 数据 源 ) ， 以 及 如 何 添加 自 定义 的 拦截 器 到 拦截 器 处 理 链 中 。 


最 后 用 读者 就 知 的 JVM 作 为 参考 介绍 了 Activiti 引 擎 的 基础 实现 PVM (流程 虚拟 机 ) ， 并 通过 示例 了 解 其 运作 过 程 ， 以 加 深 读者 对 流程 驱动 原理 的 理解 。 


